{
  "openapi": "3.0.1",
  "info": {
    "title": "IMDb Scraper: Movies, TV, Ratings, Cast and Reviews",
    "description": "Scrape IMDb by chart (Top 250, Most Popular, Box Office), keyword, filters, list or link: one row per title with rating, votes, genres, runtime, cast, directors, plot, release date, box office, Metascore and awards, plus people and optional user reviews. No login.",
    "version": "0.1",
    "x-build-id": "t2z6pP86gyPKBTulN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~imdb-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~imdb-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-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/themineworks~imdb-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-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",
        "properties": {
          "charts": {
            "title": "IMDb charts",
            "type": "array",
            "description": "IMDb charts to export, each in chart order with its rank. Top 250 lists hold 250 titles, Most Popular and Lowest Rated 100, Box Office the 10 films of the latest US weekend with the weekend gross.",
            "items": {
              "type": "string",
              "enum": [
                "top-250-movies",
                "most-popular-movies",
                "top-250-tv",
                "most-popular-tv",
                "box-office",
                "lowest-rated-movies",
                "top-english-movies",
                "top-indian-movies",
                "top-tamil-movies",
                "top-telugu-movies",
                "top-malayalam-movies"
              ],
              "enumTitles": [
                "Top 250 Movies",
                "Most Popular Movies (MOVIEmeter)",
                "Top 250 TV Shows",
                "Most Popular TV Shows (TVmeter)",
                "Box Office (latest US weekend)",
                "Lowest Rated Movies",
                "Top Rated English Movies",
                "Top Rated Indian Movies",
                "Top Rated Tamil Movies",
                "Top Rated Telugu Movies",
                "Top Rated Malayalam Movies"
              ]
            }
          },
          "searchTerms": {
            "title": "Keywords",
            "type": "array",
            "description": "Words to search on IMDb, one per line, as you would type them in the IMDb search box. Example: batman, breaking bad, christopher nolan. Each keyword is one search.",
            "items": {
              "type": "string"
            }
          },
          "searchType": {
            "title": "Search for",
            "enum": [
              "titles",
              "people"
            ],
            "type": "string",
            "description": "Titles (movies, TV shows, episodes, games) or people (actors, directors, writers). Filters below apply to title searches only.",
            "default": "titles"
          },
          "startUrls": {
            "title": "IMDb links or ids",
            "type": "array",
            "description": "IMDb links or ids, one per line: a title (https://www.imdb.com/title/tt0111161/ or tt0111161), its reviews page, a person (/name/nm0634240/), a public list (/list/ls055592025/), a chart (/chart/top/, /chart/moviemeter/, /chart/toptv/, /chart/boxoffice/), a find link (/find/?q=dune) or an advanced search link (/search/title/?genres=horror&title_type=feature).",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max titles or people per source",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "The most rows to return for each chart, keyword, filter search, list or search link, 1 to 10,000. Single title and name links always return their row.",
            "default": 50
          },
          "titleTypes": {
            "title": "Title types",
            "type": "array",
            "description": "Only these kinds of titles. Empty means all. Using any filter switches keyword searches to IMDb's advanced title search.",
            "items": {
              "type": "string",
              "enum": [
                "movie",
                "tvSeries",
                "tvMiniSeries",
                "tvMovie",
                "tvSpecial",
                "tvEpisode",
                "short",
                "tvShort",
                "video",
                "videoGame",
                "musicVideo",
                "podcastSeries"
              ],
              "enumTitles": [
                "Movie",
                "TV series",
                "TV mini series",
                "TV movie",
                "TV special",
                "TV episode",
                "Short",
                "TV short",
                "Video",
                "Video game",
                "Music video",
                "Podcast series"
              ]
            }
          },
          "genres": {
            "title": "Genres",
            "type": "array",
            "description": "Only titles that have ALL these genres. Empty means any genre.",
            "items": {
              "type": "string",
              "enum": [
                "Action",
                "Adventure",
                "Animation",
                "Biography",
                "Comedy",
                "Crime",
                "Documentary",
                "Drama",
                "Family",
                "Fantasy",
                "Film-Noir",
                "Game-Show",
                "History",
                "Horror",
                "Music",
                "Musical",
                "Mystery",
                "News",
                "Reality-TV",
                "Romance",
                "Sci-Fi",
                "Short",
                "Sport",
                "Talk-Show",
                "Thriller",
                "War",
                "Western"
              ]
            }
          },
          "releaseYearFrom": {
            "title": "Released from year",
            "minimum": 1870,
            "maximum": 2100,
            "type": "integer",
            "description": "Only titles released in or after this year, for example 2015."
          },
          "releaseYearTo": {
            "title": "Released up to year",
            "minimum": 1870,
            "maximum": 2100,
            "type": "integer",
            "description": "Only titles released in or before this year, for example 2024."
          },
          "minRating": {
            "title": "Minimum IMDb rating",
            "minimum": 1,
            "maximum": 10,
            "type": "number",
            "description": "Only titles rated at least this, 1 to 10, for example 7.5."
          },
          "minVotes": {
            "title": "Minimum number of votes",
            "minimum": 0,
            "type": "integer",
            "description": "Only titles with at least this many IMDb ratings, for example 10000. Useful with a rating filter or rating sort to skip obscure titles."
          },
          "countries": {
            "title": "Countries of origin",
            "type": "array",
            "description": "Two letter country codes, for example US, GB, IN, KR. Only titles from any of these countries.",
            "items": {
              "type": "string"
            }
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Two letter language codes, for example en, hi, ko, es. Only titles in any of these languages.",
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort filter results by",
            "enum": [
              "popularity",
              "rating",
              "votes",
              "newest",
              "oldest",
              "box_office",
              "metascore",
              "runtime",
              "title"
            ],
            "type": "string",
            "description": "Order of filter search results. Keyword searches without filters keep IMDb's own relevance order."
          },
          "castLimit": {
            "title": "Cast members per title",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "How many cast members (with character names) to keep in each title row, 0 to 100. The first three also fill the stars field.",
            "default": 15
          },
          "includeReviews": {
            "title": "Add user reviews",
            "type": "boolean",
            "description": "On: each title also returns up to the number of reviews below, one row per review (rating, headline, text, date, helpful votes, spoiler flag, reviewer display name). Reviews are charged per review row.",
            "default": false
          },
          "maxReviewsPerTitle": {
            "title": "Max reviews per title",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Up to how many reviews to return for each title, 1 to 5,000.",
            "default": 20
          },
          "reviewsSort": {
            "title": "Review order",
            "enum": [
              "helpful",
              "newest",
              "oldest",
              "highest_rating",
              "lowest_rating",
              "most_votes"
            ],
            "type": "string",
            "description": "Which reviews come first.",
            "default": "helpful"
          },
          "excludeSpoilers": {
            "title": "Skip reviews marked as spoilers",
            "type": "boolean",
            "description": "On: reviews the author marked as containing spoilers are left out.",
            "default": false
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}