# TheMovieDB Scraper - Low-cost💲🔥🎬🌍 (`delectable_incubator/themoviedb-scraper-low-cost`) Actor

🎬 Scrape TheMovieDB (TMDB) to extract movies, TV shows, actors, directors, production companies, release dates, genres, ratings, countries, collections, networks, and more. Ideal for entertainment research, media analytics, recommendation engines, and AI datasets. 🌍📊

- **URL**: https://apify.com/delectable\_incubator/themoviedb-scraper-low-cost.md
- **Developed by:** [Prime Scrape](https://apify.com/delectable_incubator) (community)
- **Categories:** Lead generation, Videos, Automation
- **Stats:** 2 total users, 1 monthly users, 50.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00005 / actor start

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

<p align="center">
  <img src="https://i.ibb.co/jkNS73wX/readme.png" alt="TheMovieDB Scraper" width="100%">
</p>

---

## 🎬🌍 TheMovieDB (TMDB) Scraper | Bulk Movies, TV Shows & People Scraper | Apify Actor

### 🚀 Extract TheMovieDB (TMDB) Data in Seconds (No Code)

The **TheMovieDB (TMDB) Scraper** is a powerful, scalable, and SEO-optimized Apify Actor built to extract movies, TV shows, actors, directors, collections, production companies, TV networks, awards, and entertainment metadata directly from **TheMovieDB.org (TMDB)**.

Scrape thousands of TMDB search results in bulk for movie analytics, recommendation engines, streaming platforms, AI datasets, media intelligence, entertainment research, and content discovery.

---

## 🔥 Why This TMDB Scraper?

✔ Best TheMovieDB (TMDB) Scraper on Apify

✔ Supports **Bulk Keyword Scraping (Multi-Search)**

✔ Extract Movies, TV Shows, People, Networks & Companies

✔ Fast & scalable entertainment data extraction

✔ 100% structured JSON / CSV / Excel output

✔ Perfect for media platforms & AI projects

✔ Enterprise-ready scraping engine

✔ No coding required

---

## 🎯 What This Scraper Does (TMDB Data Extraction)

This Apify Actor extracts real-time search results directly from **TheMovieDB (TMDB)**.

#### 📌 Core Features

✅ Scrape TMDB movies

✅ Scrape TV shows

✅ Scrape actors, directors & celebrities

✅ Scrape movie collections

✅ Scrape TV networks

✅ Scrape production companies

✅ Scrape keywords & awards

✅ **Bulk keyword search support (SEO BOOST 🚀)**

✅ Automatic pagination

✅ Extract release dates

✅ Extract countries

✅ Extract poster images

✅ Extract descriptions

✅ Extract TMDB URLs

✅ High-speed extraction engine

---

## ⚡ Input Configuration (Simple & Powerful)

### 🔥 BULK KEYWORD MODE (SEO BOOST 🚀)

````

{
"keywords": \[
"Marvel",
"Batman",
"Harry Potter",
"Netflix",
"Christopher Nolan",
"Pixar"
],
"content\_type": "movie",
"max\_items": 500
}

```

Supported content types:

- movie
- tv
- person
- collection
- keyword
- company
- network
- award

---

## 📊 Extracted Data (Structured Output)

| Field | Description |
|------|-------------|
| contentType | Movie, TV, Person, Company, Network, Collection, Award |
| itemId | TMDB unique ID |
| title | Movie or TV show title |
| name | Person or organization name |
| collectionName | Collection title |
| keyword | TMDB keyword |
| companyName | Production company |
| networkName | TV network |
| awardName | Award name |
| releaseDate | Release date |
| role | Known for / department |
| country | Country |
| overview | Description |
| posterUrl | Poster image |
| logoUrl | Company or network logo |
| itemUrl | Direct TMDB URL |

---

## 💡 Use Cases (High Demand SEO Keywords)

Perfect for:

🎬 Movie database extraction

📺 TV show analytics

🎭 Actor & celebrity datasets

🍿 Streaming platform intelligence

🤖 AI training datasets

🎞️ Movie recommendation engines

📈 Entertainment market research

🏢 Production company analysis

📊 Film industry analytics

⚡ Bulk TMDB scraping

---

## 🚀 Key Features (Apify SEO Optimized)

⚡ Bulk keyword scraping

🌍 Worldwide entertainment database

🎬 Movies & TV shows

🎭 Actors & directors

🏢 Production companies

📺 TV networks

📌 Smart pagination

🧠 Structured datasets

📊 High-speed scraping

💾 Export-ready data

⚙️ Cloud execution with Apify

---

## 📤 Output Formats Supported

✔ JSON

✔ CSV

✔ Excel XLSX

✔ XML

✔ HTML

---

## 📦 Example Output

```

{
"contentType": "movie",
"itemId": "603",
"title": "The Matrix",
"releaseDate": "1999-03-31",
"overview": "A computer hacker learns the true nature of reality.",
"country": "US",
"posterUrl": "https://image.tmdb.org/t/p/original/poster.jpg",
"itemUrl": "https://www.themoviedb.org/movie/603"
}

````

---

## 🔥 Why This is the BEST TMDB Scraper on Apify?

✔ Optimized for Apify marketplace ranking

✔ High-performance TMDB extraction

✔ Bulk keyword support

✔ Multi-content search engine

✔ Enterprise-ready scalability

✔ AI dataset generation

✔ Perfect for media intelligence

✔ Designed for maximum SEO visibility

---

## 💸 Pricing

This scraper runs on a **pay-per-result** pricing model.

You only pay for successfully extracted records.

💳 **Price:** $4.98 / 1,000 results

---

## ❓ FAQ (SEO BOOST SECTION)

#### Can I scrape multiple keywords at once?

Yes — Bulk Keyword Mode is fully supported.

#### Which content types are supported?

Movies, TV Shows, People, Companies, Networks, Collections, Keywords and Awards.

#### Can I scrape actors and directors?

Yes. Use the **person** content type.

#### Does the scraper support pagination?

Yes — pagination is handled automatically.

#### Can I export the data?

Yes — JSON, CSV, Excel, XML and HTML are supported.

#### Is coding required?

No. This is a fully no-code Apify Actor.

---

## ⚠️ Disclaimer

This tool is **not affiliated with TheMovieDB (TMDB)**. It is an independent data extraction solution built for publicly available information.

---

## 🔗 Related Actors (PrimeScrape Entertainment Suite)

We are building a complete **PrimeScrape Entertainment Intelligence Suite**.

👉 Coming Soon 🚀

---

## 🌍 PrimeScrape Ecosystem

Built for large-scale scraping, automation, AI datasets, and market intelligence.

🎬 Entertainment data

📺 Streaming analytics

🎭 Celebrity intelligence

🏢 Company datasets

📈 Market analytics

🤖 AI training datasets

⚙️ Automation pipelines

---

## 📬 Support

⭐⭐⭐⭐⭐ **Love this scraper? Leave a 5-star review!**

Need custom scraping solutions, enterprise integrations, or dedicated features?

The **PrimeScrape** team is here to help.

# Actor input Schema

## `keywords` (type: `array`):

List of keywords. Each keyword will be scraped separately, with its own item limit (see max_items).
## `content_type` (type: `string`):

Type of content to search for on TheMovieDB
## `max_items` (type: `integer`):

Limits how many items will be scraped for EACH keyword.

## Actor input object example

```json
{
  "keywords": [
    "drama",
    "romance"
  ],
  "content_type": "movie",
  "max_items": 100
}
````

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "drama",
        "romance"
    ],
    "content_type": "movie",
    "max_items": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("delectable_incubator/themoviedb-scraper-low-cost").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": [
        "drama",
        "romance",
    ],
    "content_type": "movie",
    "max_items": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("delectable_incubator/themoviedb-scraper-low-cost").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 '{
  "keywords": [
    "drama",
    "romance"
  ],
  "content_type": "movie",
  "max_items": 100
}' |
apify call delectable_incubator/themoviedb-scraper-low-cost --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=delectable_incubator/themoviedb-scraper-low-cost",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "TheMovieDB Scraper - Low-cost💲🔥🎬🌍",
        "description": "🎬 Scrape TheMovieDB (TMDB) to extract movies, TV shows, actors, directors, production companies, release dates, genres, ratings, countries, collections, networks, and more. Ideal for entertainment research, media analytics, recommendation engines, and AI datasets. 🌍📊",
        "version": "0.0",
        "x-build-id": "zix6t5uAkuUAPidcV"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/delectable_incubator~themoviedb-scraper-low-cost/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-delectable_incubator-themoviedb-scraper-low-cost",
                "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/delectable_incubator~themoviedb-scraper-low-cost/runs": {
            "post": {
                "operationId": "runs-sync-delectable_incubator-themoviedb-scraper-low-cost",
                "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/delectable_incubator~themoviedb-scraper-low-cost/run-sync": {
            "post": {
                "operationId": "run-sync-delectable_incubator-themoviedb-scraper-low-cost",
                "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": [
                    "keywords",
                    "content_type"
                ],
                "properties": {
                    "keywords": {
                        "title": "Keywords to Search on TheMovieDB #️⃣",
                        "type": "array",
                        "description": "List of keywords. Each keyword will be scraped separately, with its own item limit (see max_items).",
                        "default": [
                            "drama",
                            "romance"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "content_type": {
                        "title": "Content Type 🎬",
                        "enum": [
                            "movie",
                            "tv",
                            "person",
                            "collection",
                            "keyword",
                            "network",
                            "company",
                            "award"
                        ],
                        "type": "string",
                        "description": "Type of content to search for on TheMovieDB",
                        "default": "movie"
                    },
                    "max_items": {
                        "title": "Maximum number of items to scrape per keyword 🔢",
                        "type": "integer",
                        "description": "Limits how many items will be scraped for EACH keyword.",
                        "default": 100
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```