Media

IMDb Titles

IMDb film and series metadata — title, year, type, rating, genres, runtime, plot and people.

imdb-titlesimdbmediafilmtv

6 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/imdb-titles/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 6 rows, this download costs 1 credit when the data is fresh enough, or 2 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/imdb-titles/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "titleIds": [        "tt0120338"      ],      "includeImages": false,      "maxImages": 12,      "maxTitles": 200    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

titleIds
string[]
Title ids
IMDb ids. A bare number or a full imdb.com/title/… URL is accepted and normalised.
Default
["tt0120338"]
Example
tt0120338

Advanced

includeImages
boolean
Collect the still gallery
Off by default: the poster is always kept, and the gallery is a long tail of stills that dominates the row size.
Default
false
maxImages
number
Max gallery images
Ignored unless the gallery is collected.
Default
12
Range
1 to 100
maxTitles
number
Max titles per run
Ceiling on how many of the listed ids are fetched. Rows upsert, so this bounds one run rather than the dataset.
Default
200
Range
1 to 5000
requestDelayMs
number
Delay between requests (ms)
IMDb's WAF escalates on request rate. Lowering this is the fastest way to get a run blocked.
Default
1500
Range
0 to 60000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "titleIds": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Title ids",      "description": "IMDb ids. A bare number or a full imdb.com/title/… URL is accepted and normalised.",      "default": [        "tt0120338"      ],      "examples": [        "tt0120338"      ]    },    "includeImages": {      "type": "boolean",      "title": "Collect the still gallery",      "description": "Off by default: the poster is always kept, and the gallery is a long tail of stills that dominates the row size.",      "default": false    },    "maxImages": {      "type": "number",      "minimum": 1,      "maximum": 100,      "title": "Max gallery images",      "description": "Ignored unless the gallery is collected.",      "default": 12    },    "maxTitles": {      "type": "number",      "minimum": 1,      "maximum": 5000,      "title": "Max titles per run",      "description": "Ceiling on how many of the listed ids are fetched. Rows upsert, so this bounds one run rather than the dataset.",      "default": 200    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "description": "IMDb's WAF escalates on request rate. Lowering this is the fastest way to get a run blocked.",      "default": 1500    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/imdb-titles/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "titleIds": [        "tt0120338"      ],      "includeImages": false,      "maxImages": 12,      "maxTitles": 200    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
certificate	string	100%
end_year	number	17%
genres	array	100%
imdb_id	string	100%
languages	array	100%
plot	string	100%
popularity_rank	number	100%
poster_url	string	100%
rating	number	100%
release_date	date	100%
runtime_minutes	number	100%
stars	array	100%
title	string	100%
title_type	string	100%
title_type_label	string	100%
vote_count	number	100%
writers	array	17%
year	number	100%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
updated_at	date	100%
_id	string	100%