# IMDb Scraper — Movies, TV, Ratings, Reviews & Cast API (`logiover/imdb-scraper`) Actor
Unofficial IMDb API powered by IMDb's own GraphQL — no key, no browser. Search movies & TV by genre/year/rating/votes, pull title details, cast & crew, episode lists, user reviews and ratings. Export IMDb datasets to JSON, CSV or Excel. For film analytics, ML and recommendations.
- **URL**: https://apify.com/logiover/imdb-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Videos, Business, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## IMDb Scraper — Movies, TV, Ratings, Reviews & Cast Data API (No API Key)
    
An **unofficial IMDb scraper** and structured **IMDb data API** in a single Apify Actor. Search movies and TV shows, pull full title details, ratings, user reviews, complete episode lists, and cast & crew — powered directly by **IMDb's own public GraphQL** endpoint. No API key, no login, no headless browser — just fast HTTP and clean, flat JSON you can export to CSV, Excel or JSON. **Six modes share one input form**, and every result is tagged with `_mode` so you can mix modes in a single dataset and filter later.
> ### 🏆 Why this IMDb scraper?
> **6 modes in 1 Actor** (advanced search, free-text search, title details, episodes, reviews, people) · powered by IMDb's own GraphQL · **hundreds of thousands of titles reachable** via advanced search · ratings + votes on every title & episode · export to JSON / CSV / Excel. The unofficial **IMDb API alternative** for film & TV analytics, recommendation engines, ML datasets and AI agents — with **no API key** and **no browser**.
---
### ✨ What this Actor does / Key features
- 🔍 **Advanced title search** — filter tens of thousands of movies and TV shows by title type, genre, release-date range, IMDb rating and vote count; sort by popularity, rating, release date, runtime, box office or Metascore; paginates the full result set.
- ⭐ **Ratings everywhere** — `aggregateRating` and `voteCount` on every title and episode, straight from IMDb.
- 🎬 **Rich title details** — `title`, `originalTitle`, `titleType`, `year`, `endYear`, `runtimeMinutes`, `genres[]`, `plot`, poster `imageUrl`, popularity rank and top `topCredits[]` (director, writers, cast).
- 📺 **Full episode lists** — every episode of a series with `seasonNumber`, `episodeNumber`, `releaseDate`, per-episode rating and plot.
- 💬 **User reviews** — reviewer, star rating, summary, full review text, submission date and helpfulness up/down votes.
- 👤 **People (cast & crew)** — `name`, professions, biography, birth/death dates, photo and a `knownFor[]` filmography.
- 🧩 **Batch lookups** — feed many `tt…` or `nm…` IDs at once for `titleDetails` and `name` modes.
- 🗂️ **5 pre-built dataset views** — Overview, Titles, Episodes, Reviews, People — slice the data with zero post-processing.
- ⚡ **Direct GraphQL** — no browser, no API key, no OAuth; every item carries `_mode` and `scrapedAt` (ISO 8601).
#### The 6 modes
| Mode | What it returns |
|---|---|
| `searchTitles` | Advanced movie/TV search — filter by type, genre, year, rating, votes (highest volume) |
| `search` | Free-text search across titles, people and companies |
| `titleDetails` | Full details for one or many title IDs (batch) |
| `episodes` | Every episode of a TV series, paginated |
| `reviews` | User reviews for a title, paginated |
| `name` | Person / cast / crew details for one or many name IDs (batch) |
### 🚀 Quick start (3 steps)
1. **Pick a Mode** — start with `searchTitles` to build a filtered movie/TV dataset, or use `titleDetails` / `reviews` / `episodes` / `name` with an IMDb ID.
2. **Fill the fields that mode needs** — the input form shows which apply (search filters, or a `titleId` like `tt0111161` / `nameId` like `nm0000138`).
3. **Run & export** — download results as **JSON, CSV, Excel, HTML, RSS or JSON Lines**, or pull them via the Apify API.
### 📥 Input
Pick a `mode`, then fill only the fields that mode needs.
#### Example — advanced search for popular movies since 2020
```json
{
"mode": "searchTitles",
"titleTypes": ["movie"],
"releaseDateStart": "2020-01-01",
"minVotes": 5000,
"sortBy": "POPULARITY",
"maxResults": 200
}
````
#### Example — pull user reviews for a title
```json
{
"mode": "reviews",
"titleId": "tt0111161",
"maxResults": 500
}
```
#### Example — batch title details for several movies
```json
{
"mode": "titleDetails",
"titleIds": ["tt0111161", "tt0068646", "tt0468569"]
}
```
| Field | Type | Used by | Description |
|-------|------|---------|-------------|
| `mode` | string | all | `searchTitles`, `search`, `titleDetails`, `episodes`, `reviews` or `name`. **Required.** |
| `query` | string | search | Free-text term (movie, show, actor, director or company). |
| `searchType` | string | search | Restrict to `TITLE`, `NAME`, `COMPANY` or `KEYWORD`. |
| `titleTypes` | array | searchTitles | `movie`, `tvSeries`, `tvMiniSeries`, `tvMovie`, `short`, `videoGame`… (defaults to `movie`). |
| `genres` | array | searchTitles | One or more genres (all must match): Action, Comedy, Drama, Sci-Fi… |
| `releaseDateStart` / `releaseDateEnd` | string | searchTitles | Release-date window (`YYYY-MM-DD`). |
| `minRating` / `maxRating` | integer | searchTitles | IMDb average rating bounds (0–10). |
| `minVotes` | integer | searchTitles | Minimum vote count (filters out obscure entries). |
| `sortBy` | string | searchTitles | `POPULARITY`, `USER_RATING`, `USER_RATING_COUNT`, `RELEASE_DATE`, `RUNTIME`, `BOX_OFFICE_GROSS_DOMESTIC`, `METACRITIC_SCORE`. |
| `sortOrder` | string | searchTitles | `ASC` or `DESC`. |
| `titleId` / `titleIds` | string / array | titleDetails, episodes, reviews | IMDb title ID(s) like `tt0111161` (titleDetails accepts a batch). |
| `nameId` / `nameIds` | string / array | name | IMDb person ID(s) like `nm0000138` (batch supported). |
| `maxResults` | integer | all | Row cap; drives pagination for search/episodes/reviews. |
| `country` / `language` | string | all | Localization: `US` / `en-US`, `DE` / `de-DE`, `TR` / `tr-TR`… |
### 📤 Output
Results stream to the dataset; every item carries `_mode` and `scrapedAt`. Here is a trimmed **title** sample (from `searchTitles` / `titleDetails`):
```json
{
"_mode": "searchTitles",
"id": "tt0111161",
"title": "The Shawshank Redemption",
"titleType": "movie",
"year": 1994,
"aggregateRating": 9.3,
"voteCount": 2894512,
"runtimeMinutes": 142,
"genres": ["Drama"],
"plot": "Over the course of several years, two convicts form a friendship…",
"imageUrl": "https://m.media-amazon.com/images/…/poster.jpg",
"imdbUrl": "https://www.imdb.com/title/tt0111161/",
"scrapedAt": "2026-07-06T12:00:00.000Z"
}
```
And a trimmed **review** sample (from `reviews` mode):
```json
{
"_mode": "reviews",
"titleName": "The Shawshank Redemption",
"author": "alexdrama",
"authorRating": 10,
"summary": "A near-perfect film",
"text": "Few films earn their reputation the way this one does…",
"submissionDate": "2026-05-18",
"upVotes": 142,
"downVotes": 6,
"scrapedAt": "2026-07-06T12:00:00.000Z"
}
```
📋 Full field reference by mode (click to expand)
**Titles** (`searchTitles`, `search`, `titleDetails`): `id`, `title`, `originalTitle`, `titleType`, `year`, `endYear`, `aggregateRating`, `voteCount`, `runtimeMinutes`, `genres[]`, `plot`, `imageUrl`, `topCredits[]`, `imdbUrl`
**Episodes** (`episodes`): `seriesTitle`, `seasonNumber`, `episodeNumber`, `title`, `releaseDate`, `aggregateRating`, `voteCount`, `plot`, `imdbUrl`
**Reviews** (`reviews`): `titleName`, `author`, `authorRating`, `summary`, `text`, `submissionDate`, `upVotes`, `downVotes`
**People** (`name`): `id`, `name`, `professions[]`, `birthDate`, `deathDate`, `bio`, `imageUrl`, `knownFor[]`, `imdbUrl`
**Universal** (every row): `_mode`, `imdbUrl`, `scrapedAt` (ISO 8601)
### 💡 Use cases
- **Film & TV analytics** — build a movie ratings dataset filtered by genre, decade and popularity, then chart trends in a BI tool.
- **Recommendation engines & ML** — bulk-ingest titles, genres, ratings and cast to train content-based or collaborative recommenders.
- **Review mining & sentiment** — pull IMDb user reviews for a film or series and feed sentiment models or LLM summarizers.
- **Catalog enrichment** — enrich your own media catalog with IMDb metadata, posters, runtimes and cast lists via `titleDetails`.
- **Market & competitor research** — track top-rated or most-popular releases per year, monitor a studio's back catalog, or benchmark a show's episode ratings.
- **AI agents & RAG** — wrap the Actor as a tool so an LLM can answer "what are the top-rated sci-fi movies since 2020?" or embed plots and reviews.
### 👥 Who uses it
Film & TV data analysts · recommendation-engine and ML engineers · streaming & catalog teams enriching metadata · journalists and researchers · sentiment/NLP practitioners mining reviews · AI-agent builders wiring IMDb as a tool.
### 💰 Pricing
This Actor runs on a simple **pay-per-result** model — you pay for the items you extract, with no separate Apify platform fees to calculate. Try it on the **free tier** first, then scale up. See the **Pricing** tab on this page for the current rate.
### ❓ Frequently Asked Questions
**Do I need an IMDb API key or account?**
No. This is an unofficial IMDb scraper that reads publicly available data through IMDb's own GraphQL endpoint. You only need an Apify account — no IMDb API key, no OAuth, no login.
**Is this an IMDb API or an IMDb API alternative?**
Both, effectively. It works as an unofficial **IMDb API** and a practical **IMDb dataset API alternative**: send structured input, get structured JSON back, without the restricted official IMDb datasets or paid data licenses.
**How do I scrape IMDb ratings and vote counts?**
Every title and episode row includes `aggregateRating` (the IMDb average) and `voteCount`. Use `searchTitles` to build a filtered ratings dataset, or `titleDetails` for specific movies.
**How do I get IMDb IDs (tt and nm)?**
A title ID looks like `tt0111161` (the digits after `tt` in an IMDb title URL); a person ID looks like `nm0000138`. Use `search` or `searchTitles` first to discover IDs, then feed them into `titleDetails`, `episodes`, `reviews` or `name`.
**Can I scrape IMDb reviews without an API key?**
Yes. Pick `reviews` mode, set the `titleId`, and the Actor paginates the public review feed — reviewer, star rating, full text, date and helpfulness votes — no key or login required.
**Does it cover TV series and episodes?**
Yes. Use `searchTitles` with `titleTypes: ["tvSeries"]` to find shows, then `episodes` mode with the series `titleId` to pull every episode with season/episode numbers and per-episode ratings.
**How much data can advanced search return?**
Advanced title search runs against IMDb's full catalog — a single filter set can match hundreds of thousands of titles. The Actor paginates up to your `maxResults`, so you can pull large movie and TV datasets in one run.
**Is the data localized by country?**
You can set `country` and `language` (e.g. `US` / `en-US`, `DE` / `de-DE`) to influence IMDb localization of titles and text.
**How do I export IMDb data to CSV, JSON or Excel?**
Run any mode and download the dataset as CSV, JSON, Excel (XLSX), HTML, RSS or JSON Lines from the run page, or pull it via the Apify API. This makes it a simple IMDb data export and movie-dataset tool.
**Is it legal to scrape IMDb?**
The Actor collects only publicly available data served by IMDb's own endpoints. You are responsible for using the data in compliance with IMDb's terms and applicable laws.
### 🔗 More media & social scrapers by logiover
Building a media, entertainment or social dataset? Pair IMDb with the rest of the suite:
| Actor | What it does |
|---|---|
| [TVmaze Scraper](https://apify.com/logiover/tvmaze-scraper) | TV show schedules, episodes and cast from TVmaze |
| [MyAnimeList Scraper](https://apify.com/logiover/mal-anime-scraper) | Anime & manga titles, scores and metadata |
| [Letterboxd Film Review Scraper](https://apify.com/logiover/letterboxd-film-review-scraper) | Film reviews, ratings and lists from Letterboxd |
| [Steam Game Reviews Scraper](https://apify.com/logiover/steam-game-reviews-scraper) | Player reviews and ratings from Steam |
| [Discogs Scraper](https://apify.com/logiover/discogs-scraper) | Music releases, artists and labels from Discogs |
| [Apple Podcasts Episode Scraper](https://apify.com/logiover/apple-podcasts-episode-scraper) | Podcast episodes and show metadata |
| [YouTube Video Details Scraper](https://apify.com/logiover/youtube-video-details-scraper) | Video stats, metadata and channel info |
| [YouTube Comments Scraper](https://apify.com/logiover/youtube-comments-scraper) | Comment threads and engagement from YouTube |
| [Twitch Scraper](https://apify.com/logiover/twitch-scraper) | Streams, channels and metadata from Twitch |
| [Reddit Subreddit Scraper](https://apify.com/logiover/reddit-subreddit-scraper) | Posts, scores and comments from any subreddit |
| [Resident Advisor Scraper](https://apify.com/logiover/resident-advisor-scraper) | Music events, clubs and lineups |
| [Wikipedia Category Scraper](https://apify.com/logiover/wikipedia-category-scraper) | Walk Wikipedia categories and export page metadata |
👉 Browse all **[logiover scrapers on Apify Store](https://apify.com/logiover)** — 180+ actors across real estate, jobs, crypto, social media & B2B data.
### ⏰ Scheduling & integration
Schedule this Actor on Apify to refresh a movie/TV dataset daily or weekly. Export results to JSON, CSV or Excel, sync to Google Sheets, or push to your database, BI tools and webhooks through the Apify API. Call it from your stack via `run-sync-get-dataset-items`, the JavaScript/Python clients, or no-code tools like **Make, n8n and Zapier**.
### ⭐ Support & feedback
Found a bug or need an extra field or mode? Open an issue on the **Issues** tab — response is usually fast. If this Actor saves you time, a **★★★★★ review** on the Store page genuinely helps and is hugely appreciated. 🙏
### ⚖️ Legal
This Actor extracts only publicly available data served by IMDb's own endpoints and is intended for legitimate research, analytics and dataset-building use. You are responsible for complying with IMDb's terms of service and any applicable local laws.
***
### 📝 Changelog
#### 2026-07-06
- ✨ README overhaul: added shields badges, a richer per-mode output sample and field reference, ready-to-run example scenarios, a media/social cross-promo grid, and a clearer quick-start.
#### 2026-07-01
- Initial release: six IMDb modes (advanced title search, free-text search, title details, episodes, reviews, people) over IMDb's public GraphQL — no key, no browser.
# Actor input Schema
## `mode` (type: `string`):
Which IMDb endpoint to run.
• **searchTitles** — advanced movie/TV search: filter by type, genre, year, rating and votes; paginates through tens of thousands of matches (highest volume)
• **search** — free-text search across titles, people and companies
• **titleDetails** — full details for one or more title IDs (batch)
• **episodes** — every episode of a TV series (paginated)
• **reviews** — user reviews for a title (paginated)
• **name** — person / cast / crew details for one or more name IDs (batch)
## `query` (type: `string`):
Free-text term for **search** mode (movie name, show, actor, director or company).
## `searchType` (type: `string`):
Restrict **search** results to one entity type. Leave empty to search everything.
## `titleTypes` (type: `array`):
Filter **searchTitles** by title type. Valid IDs: `movie`, `tvSeries`, `tvMiniSeries`, `tvMovie`, `tvSpecial`, `tvShort`, `short`, `video`, `videoGame`, `musicVideo`, `podcastSeries`, `podcastEpisode`. Leave empty to default to `movie`.
## `genres` (type: `array`):
Filter by one or more genres (all must match). Valid values: Action, Adventure, Animation, Biography, Comedy, Crime, Documentary, Drama, Family, Fantasy, Film-Noir, History, Horror, Music, Musical, Mystery, News, Reality-TV, Romance, Sci-Fi, Sport, Thriller, War, Western.
## `releaseDateStart` (type: `string`):
Only titles released on/after this date. Format `YYYY-MM-DD`.
## `releaseDateEnd` (type: `string`):
Only titles released on/before this date. Format `YYYY-MM-DD`.
## `minRating` (type: `integer`):
Only titles with an average IMDb rating at or above this value.
## `maxRating` (type: `integer`):
Only titles with an average IMDb rating at or below this value.
## `minVotes` (type: `integer`):
Only titles with at least this many user ratings. Great for filtering out obscure entries (e.g. 1000+).
## `sortBy` (type: `string`):
Ordering field for advanced title search.
## `sortOrder` (type: `string`):
ASC = most popular / lowest value first (for POPULARITY, ASC = most popular). DESC = highest value first.
## `titleId` (type: `string`):
IMDb title ID, e.g. `tt0111161`. Used by **titleDetails**, **episodes**, **reviews**. The digits after `tt` in an IMDb URL.
## `titleIds` (type: `array`):
Array of IMDb title IDs (`tt…`) for batch **titleDetails**.
## `nameId` (type: `string`):
IMDb person ID, e.g. `nm0000138`. Used by **name** mode.
## `nameIds` (type: `array`):
Array of IMDb person IDs (`nm…`) for batch **name** lookups.
## `maxResults` (type: `integer`):
Upper bound on rows returned. For searchTitles/episodes/reviews this drives pagination; for search it caps a single page (≤200).
## `country` (type: `string`):
ISO 3166-1 alpha-2 code used for IMDb localization headers, e.g. `US`, `GB`, `DE`, `TR`.
## `language` (type: `string`):
BCP 47 language tag for IMDb localization, e.g. `en-US`, `de-DE`, `tr-TR`.
## Actor input object example
```json
{
"mode": "searchTitles",
"query": "christopher nolan",
"titleTypes": [
"movie"
],
"genres": [],
"releaseDateStart": "2020-01-01",
"releaseDateEnd": "2024-12-31",
"minVotes": 5000,
"sortBy": "POPULARITY",
"sortOrder": "ASC",
"titleId": "tt0944947",
"titleIds": [],
"nameId": "nm0000138",
"nameIds": [],
"maxResults": 120,
"country": "US",
"language": "en-US"
}
```
# Actor output Schema
## `results` (type: `string`):
Full results dataset. Use the Titles view for search modes, Episodes for episode lists, Reviews for user reviews, and People for person lookups.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"mode": "searchTitles",
"titleTypes": [
"movie"
],
"releaseDateStart": "2020-01-01",
"minVotes": 5000,
"sortBy": "POPULARITY",
"maxResults": 120
};
// Run the Actor and wait for it to finish
const run = await client.actor("logiover/imdb-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"mode": "searchTitles",
"titleTypes": ["movie"],
"releaseDateStart": "2020-01-01",
"minVotes": 5000,
"sortBy": "POPULARITY",
"maxResults": 120,
}
# Run the Actor and wait for it to finish
run = client.actor("logiover/imdb-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"mode": "searchTitles",
"titleTypes": [
"movie"
],
"releaseDateStart": "2020-01-01",
"minVotes": 5000,
"sortBy": "POPULARITY",
"maxResults": 120
}' |
apify call logiover/imdb-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=logiover/imdb-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "IMDb Scraper — Movies, TV, Ratings, Reviews & Cast API",
"description": "Unofficial IMDb API powered by IMDb's own GraphQL — no key, no browser. Search movies & TV by genre/year/rating/votes, pull title details, cast & crew, episode lists, user reviews and ratings. Export IMDb datasets to JSON, CSV or Excel. For film analytics, ML and recommendations.",
"version": "1.0",
"x-build-id": "GBEFQz2StZ5VdhMVW"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/logiover~imdb-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-logiover-imdb-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/logiover~imdb-scraper/runs": {
"post": {
"operationId": "runs-sync-logiover-imdb-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/logiover~imdb-scraper/run-sync": {
"post": {
"operationId": "run-sync-logiover-imdb-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"title": "Mode",
"enum": [
"searchTitles",
"search",
"titleDetails",
"episodes",
"reviews",
"name"
],
"type": "string",
"description": "Which IMDb endpoint to run.\n\n• **searchTitles** — advanced movie/TV search: filter by type, genre, year, rating and votes; paginates through tens of thousands of matches (highest volume)\n• **search** — free-text search across titles, people and companies\n• **titleDetails** — full details for one or more title IDs (batch)\n• **episodes** — every episode of a TV series (paginated)\n• **reviews** — user reviews for a title (paginated)\n• **name** — person / cast / crew details for one or more name IDs (batch)",
"default": "searchTitles"
},
"query": {
"title": "Search query",
"type": "string",
"description": "Free-text term for **search** mode (movie name, show, actor, director or company)."
},
"searchType": {
"title": "Search entity type",
"enum": [
"TITLE",
"NAME",
"COMPANY",
"KEYWORD"
],
"type": "string",
"description": "Restrict **search** results to one entity type. Leave empty to search everything."
},
"titleTypes": {
"title": "Title types",
"type": "array",
"description": "Filter **searchTitles** by title type. Valid IDs: `movie`, `tvSeries`, `tvMiniSeries`, `tvMovie`, `tvSpecial`, `tvShort`, `short`, `video`, `videoGame`, `musicVideo`, `podcastSeries`, `podcastEpisode`. Leave empty to default to `movie`.",
"items": {
"type": "string"
},
"default": []
},
"genres": {
"title": "Genres",
"type": "array",
"description": "Filter by one or more genres (all must match). Valid values: Action, Adventure, Animation, Biography, Comedy, Crime, Documentary, Drama, Family, Fantasy, Film-Noir, History, Horror, Music, Musical, Mystery, News, Reality-TV, Romance, Sci-Fi, Sport, Thriller, War, Western.",
"items": {
"type": "string"
},
"default": []
},
"releaseDateStart": {
"title": "Release date from (YYYY-MM-DD)",
"type": "string",
"description": "Only titles released on/after this date. Format `YYYY-MM-DD`."
},
"releaseDateEnd": {
"title": "Release date to (YYYY-MM-DD)",
"type": "string",
"description": "Only titles released on/before this date. Format `YYYY-MM-DD`."
},
"minRating": {
"title": "Minimum IMDb rating (0-10)",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Only titles with an average IMDb rating at or above this value."
},
"maxRating": {
"title": "Maximum IMDb rating (0-10)",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Only titles with an average IMDb rating at or below this value."
},
"minVotes": {
"title": "Minimum vote count",
"minimum": 0,
"type": "integer",
"description": "Only titles with at least this many user ratings. Great for filtering out obscure entries (e.g. 1000+)."
},
"sortBy": {
"title": "Sort by (searchTitles)",
"enum": [
"POPULARITY",
"USER_RATING",
"USER_RATING_COUNT",
"RELEASE_DATE",
"RUNTIME",
"BOX_OFFICE_GROSS_DOMESTIC",
"METACRITIC_SCORE"
],
"type": "string",
"description": "Ordering field for advanced title search.",
"default": "POPULARITY"
},
"sortOrder": {
"title": "Sort order",
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "ASC = most popular / lowest value first (for POPULARITY, ASC = most popular). DESC = highest value first.",
"default": "ASC"
},
"titleId": {
"title": "Title ID (tt…)",
"type": "string",
"description": "IMDb title ID, e.g. `tt0111161`. Used by **titleDetails**, **episodes**, **reviews**. The digits after `tt` in an IMDb URL."
},
"titleIds": {
"title": "Title IDs (batch, titleDetails)",
"type": "array",
"description": "Array of IMDb title IDs (`tt…`) for batch **titleDetails**.",
"items": {
"type": "string"
},
"default": []
},
"nameId": {
"title": "Name ID (nm…)",
"type": "string",
"description": "IMDb person ID, e.g. `nm0000138`. Used by **name** mode."
},
"nameIds": {
"title": "Name IDs (batch)",
"type": "array",
"description": "Array of IMDb person IDs (`nm…`) for batch **name** lookups.",
"items": {
"type": "string"
},
"default": []
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Upper bound on rows returned. For searchTitles/episodes/reviews this drives pagination; for search it caps a single page (≤200).",
"default": 200
},
"country": {
"title": "Country (localization)",
"type": "string",
"description": "ISO 3166-1 alpha-2 code used for IMDb localization headers, e.g. `US`, `GB`, `DE`, `TR`.",
"default": "US"
},
"language": {
"title": "Language (localization)",
"type": "string",
"description": "BCP 47 language tag for IMDb localization, e.g. `en-US`, `de-DE`, `tr-TR`.",
"default": "en-US"
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```