Playground Sign in Start free
Entertainment, books and games · imdb.com

How to scrape IMDb

IMDb (imdb.com) is a website. This guide is built from our own checks of its public pages: what the pages contain, whether our requests get through right now, and the request settings that worked.

Ujeebu scrapes any public website. Not listed here? Try any URL in the Playground or ask us about a site.

Working 5 credits a page, about $0.50 per 1,000 on Pro

41 of 41 of our checks passed in the last 7 days (100%).

Last check 2026-11-22 22:02 UTC · last pass 2026-11-22 22:02 UTC · checked with our own requests, never customer data.

Try it in the Playground

No one-call recipe yet for IMDb: the extract rules below do the same job in your request, or ask us.

Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →

Recipes

Public pages carry structured data (Movie). You can read those fields straight from the HTML, or select any other field with extract rules (CSS selectors). Each recipe was run on two real IMDb pages and keeps only the fields that came back on both; it is checked again every week, and hidden if it stops working.

Title pages: Public pages

Validated 2026-11-21

What these rules extract

FieldTypeExample
creative_work.descriptiontextThe aging patriarch of an organized crime dynasty transfers control...
creative_work.durationtextPT2H55M
creative_work.genretextCrime, Drama
creative_work.imageimage URLhttps://m.media-amazon.com/images/M/MV5BNGEwYjgwOGQtYjg5ZS00Njc1LTk...
creative_work.nametextThe Godfather
creative_work.publisheddate1972-03-24
creative_work.ratingnumber9.2
urlURLhttps://www.imdb.com/title/tt0068646/

Examples from www.imdb.com/title/tt0068646/ on 2026-11-21, shortened.

Sample output (real, trimmed)

{
    "creative_work": {
        "description": "The aging patriarch of an organized crime dynasty transfers control of his clandestine empire to his reluctant son.",
        "duration": "PT2H55M",
        "genre": "Crime, Drama",
        "image": "https://m.media-amazon.com/images/M/MV5BNGEwYjgwOGQtYjg5ZS00Njc1LTk2ZGEtM2QwZWQ2NjdhZTE5XkEyXkFqcGc@._V1_.jpg",
        "name": "The Godfather",
        "published": "1972-03-24",
        "rating": 9.2
    },
    "url": "https://www.imdb.com/title/tt0068646/"
}
extract_rules (2 rules)
{
    "creative_work": {
        "type": "fn",
        "fn": "const T = ['Movie', 'TVSeries', 'Book', 'MusicAlbum', 'Course', 'Recipe', 'Game', 'CreativeWorkSeries']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { description: all(g('description')), duration: all(g('duration')), genre: all(g('genre')), image: one(g('image.url|image')), name: all(g('name')), published: all(g('datePublished')), rating: all(g('aggregateRating.ratingValue')) };"
    },
    "url": {
        "selector": "link[rel=\"canonical\"]",
        "type": "attr",
        "attribute": "href"
    }
}

Search results: Search and listing pages

Validated 2026-11-22

What these rules extract

FieldTypeExample
resultslist of 3+ items
results[].urlURLhttps://www.imdb.com/title/tt1160419/?ref_=fn_i_1
results[].titletextDune
results[].imageimage URLhttps://m.media-amazon.com/images/M/MV5BNWIyNmU5MGYtZDZmNi00ZjAwLWJ...

Examples from www.imdb.com/find/ on 2026-11-22, shortened.

Sample output (real, trimmed)

{
    "results": [
        {
            "url": "https://www.imdb.com/title/tt1160419/?ref_=fn_i_1",
            "title": "Dune",
            "image": "https://m.media-amazon.com/images/M/MV5BNWIyNmU5MGYtZDZmNi00ZjAwLWJlYjgtZTc0ZGIxMDE4ZGYwXkEyXkFqcGc@._V1_QL75_UY133_CR0,0,90,133_.jpg"
        },
        {
            "url": "https://www.imdb.com/title/tt31378509/?ref_=fn_i_2",
            "title": "Dune: Part Three",
            "image": "https://m.media-amazon.com/images/M/MV5BNDhiOTAwMjktZDc0ZS00MzVmLWFkNzktOGEzZTdlNzcyNDAxXkEyXkFqcGc@._V1_QL75_UY133_CR8,0,90,133_.jpg"
        },
        {
            "url": "https://www.imdb.com/title/tt15239678/?ref_=fn_i_3",
            "title": "Dune: Part Two",
            "image": "https://m.media-amazon.com/images/M/MV5BNTc0YmQxMjEtODI5MC00NjFiLTlkMWUtOGQ5NjFmYWUyZGJhXkEyXkFqcGc@._V1_QL75_UX90_CR0,0,90,133_.jpg"
        }
    ]
}
extract_rules (1 rule)
{
    "results": {
        "selector": "li.ipc-metadata-list-summary-item",
        "type": "obj",
        "multiple": true,
        "children": {
            "url": {
                "selector": "a.ipc-lockup-overlay",
                "type": "link"
            },
            "title": {
                "selector": "h4.ipc-title__text",
                "type": "text"
            },
            "image": {
                "selector": "img",
                "type": "image"
            }
        }
    }
}

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one sends the settings on this page and the extraction recipe, prints the extracted JSON, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

Title pages: Public pages

Runs the recipe on the two pages it was validated on, one after the other.

imdb_page_sdk.py pip install ujeebu-python==0.1.5
# Scrape IMDb title pages: public pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-11-21 (Ujeebu site guide).
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 imdb_page_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://www.imdb.com/title/tt0068646/",
    "https://www.imdb.com/title/tt0468569/",
]
SETTINGS = {
    "js": True,
}
EXTRACT_RULES = {
    "creative_work": {
        "type": "fn",
        "fn": "const T = ['Movie', 'TVSeries', 'Book', 'MusicAlbum', 'Course', 'Recipe', 'Game', 'CreativeWorkSeries']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { description: all(g('description')), duration: all(g('duration')), genre: all(g('genre')), image: one(g('image.url|image')), name: all(g('name')), published: all(g('datePublished')), rating: all(g('aggregateRating.ratingValue')) };",
    },
    "url": {
        "selector": "link[rel=\"canonical\"]",
        "type": "attr",
        "attribute": "href",
    },
}


def scrape(client, url):
    # with extract_rules, client.scrape sends a JSON POST and the API answers {"result": {...}}
    try:
        response = client.scrape(url, params={**SETTINGS, "extract_rules": EXTRACT_RULES})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    print(json.dumps(scrape(client, url), indent=2, ensure_ascii=False))

Search results: Search and listing pages

Runs the recipe on the two pages it was validated on, one after the other.

imdb_listing_sdk.py pip install ujeebu-python==0.1.5
# Scrape IMDb search results: search and listing pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-11-22 (Ujeebu site guide).
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 imdb_listing_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://www.imdb.com/find/?q=dune&s=tt",
    "https://www.imdb.com/find/?q=office&s=tt",
]
SETTINGS = {
    "js": True,
}
EXTRACT_RULES = {
    "results": {
        "selector": "li.ipc-metadata-list-summary-item",
        "type": "obj",
        "multiple": True,
        "children": {
            "url": {
                "selector": "a.ipc-lockup-overlay",
                "type": "link",
            },
            "title": {
                "selector": "h4.ipc-title__text",
                "type": "text",
            },
            "image": {
                "selector": "img",
                "type": "image",
            },
        },
    },
}


def scrape(client, url):
    # with extract_rules, client.scrape sends a JSON POST and the API answers {"result": {...}}
    try:
        response = client.scrape(url, params={**SETTINGS, "extract_rules": EXTRACT_RULES})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    print(json.dumps(scrape(client, url), indent=2, ensure_ascii=False))

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/imdb.json.

Try it yourself

Run this on IMDb with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card.

URL patterns and pagination

What the URLs look like, read from the pages our checks fetched.

Title pages: Public pages

Pattern
https://www.imdb.com/title/{id}/
Validated on
https://www.imdb.com/title/tt0068646/https://www.imdb.com/title/tt0468569/

Search results: Search and listing pages

Search or listing URL
https://www.imdb.com/find/?q={query}&s=tt
Next pages
We did not see a next-page link on the pages we fetched. Results may load as you scroll: try scroll_down.
Validated on
https://www.imdb.com/find/?q=dune&s=tthttps://www.imdb.com/find/?q=office&s=tt

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Title pages

Endpoint/scrape
jstrue
wait_for8000
Costup to 5 credits a request (only HTTP 200 and 404 are billed; blocked, timed-out and failed requests are free)
Learnedjs + wait 8000 (found by our retry layer)

Each public page is one request: change the path in the URL to fetch another one. Our checks pass with JavaScript rendering on (js=true) and a wait of 8 seconds (wait_for=8000) before the snapshot: keep both.

Try it in the Playground

Search results

Endpoint/scrape
jstrue
wait_for8000
Costup to 5 credits a request (only HTTP 200 and 404 are billed; blocked, timed-out and failed requests are free)
Learnedjs + wait 8000 (found by our retry layer)

For search and listing pages, change the query or the page parameter in the URL to paginate, and fetch the pages one after another rather than in bursts. Collect detail page URLs from listing pages first, then fetch each detail page. Our checks pass with JavaScript rendering on (js=true) and a wait of 8 seconds (wait_for=8000) before the snapshot: keep both.

Try it in the Playground

Troubleshooting

The failures our own checks of imdb.com ran into over the last 7 days, and what got the page in the same check.

Search results

What happenedTimesWhat fixed it
An empty page 1 A retry with wait_for=8000 got the page (1 of 1).

What people build with IMDb data

  • Research datasetsBuild datasets of public pages for analysis, search or LLM pipelines.More on this use case

Limits and etiquette

  • Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
  • Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
  • robots.txt of www.imdb.com (read 2026-11-17): title pages asked to stay away (Disallow: /); search results asked to stay away (Disallow: /); no crawl delay set.
  • Read IMDb's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape IMDb with Ujeebu?

Yes. 41 of 41 checks of public IMDb pages passed in the last 7 days with the settings on this page.

Which settings work for IMDb?

Call /scrape with js=true, wait_for=8000. Our retry layer found that this site needs "js + wait 8000".

How many credits does a IMDb request cost?

With these settings a request costs up to 5 credits. Only responses with HTTP 200 or 404 are billed: a blocked or timed-out request is free.

Which fields can I extract from IMDb?

With the extraction recipes on this page, validated on real IMDb pages through our API: title pages: public pages: description, duration, genre, image, name, published, rating, url; search results: search and listing pages: url, title, image. Pass the recipe as extract_rules in a POST to /scrape and the API returns those fields as JSON.

Is it allowed to scrape IMDb?

Its robots.txt asks generic crawlers to stay away from title pages and search results (Disallow: /). Collect public pages only, read IMDb's terms of service, keep your request rate modest and do not collect personal data you have no basis to process. This is not legal advice.

How fresh is this page?

The status and settings come from our own health checks of imdb.com, which run around the clock. Last check: 2026-11-22 22:02:07 UTC; last pass: 2026-11-22 22:02:07 UTC.