{
  "openapi": "3.0.1",
  "info": {
    "title": "IMDb Scraper",
    "description": "[💰 $5.0 / 1K] Extract movie & TV data from IMDb — ratings, vote counts, cast, directors, genres, runtime, certificates, plot, and release year. Search by title, paste IMDb URLs, or browse the catalog by genre, year, and rating. Optional user reviews per title.",
    "version": "1.0",
    "x-build-id": "IiOyzSCtWUZQOOUmR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~imdb-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~imdb-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-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/solidcode~imdb-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-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": {
          "searchTerms": {
            "title": "Search Terms",
            "type": "array",
            "description": "Movie or TV show names to search for on IMDb, such as 'The Godfather' or 'Breaking Bad'. Each term returns its matching titles. Leave empty if using title URLs or advanced filters.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "IMDb Title URLs",
            "type": "array",
            "description": "Paste IMDb title URLs (e.g. https://www.imdb.com/title/tt0068646/) to pull full details for specific movies or shows. Also accepts bare IMDb IDs like 'tt0068646'.",
            "items": {
              "type": "string"
            }
          },
          "useAdvancedFilters": {
            "title": "Use Advanced Filters",
            "type": "boolean",
            "description": "Browse IMDb's advanced title catalog using the filters below (type, genre, year, rating) instead of (or in addition to) search terms. Turn this on to run a filtered catalog search.",
            "default": false
          },
          "titleType": {
            "title": "Title Type",
            "enum": [
              "feature",
              "tv_series",
              "tv_movie",
              "tv_episode",
              "tv_miniseries",
              "tv_special",
              "short",
              "video_game",
              "any"
            ],
            "type": "string",
            "description": "Limit results to a single kind of title. Applies ONLY when 'Use Advanced Filters' is turned on — with the checkbox off this field is ignored and the run says so. Leave it out entirely to include every title type."
          },
          "genres": {
            "title": "Genres",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include titles in these genres. Leave empty for all genres. Applies ONLY when 'Use Advanced Filters' is turned on — with the checkbox off this field is ignored and the run says so.",
            "items": {
              "type": "string",
              "enum": [
                "action",
                "adventure",
                "animation",
                "biography",
                "comedy",
                "crime",
                "documentary",
                "drama",
                "family",
                "fantasy",
                "film_noir",
                "history",
                "horror",
                "music",
                "musical",
                "mystery",
                "romance",
                "sci_fi",
                "sport",
                "thriller",
                "war",
                "western"
              ],
              "enumTitles": [
                "Action",
                "Adventure",
                "Animation",
                "Biography",
                "Comedy",
                "Crime",
                "Documentary",
                "Drama",
                "Family",
                "Fantasy",
                "Film-Noir",
                "History",
                "Horror",
                "Music",
                "Musical",
                "Mystery",
                "Romance",
                "Sci-Fi",
                "Sport",
                "Thriller",
                "War",
                "Western"
              ]
            },
            "default": []
          },
          "releaseYearMin": {
            "title": "Release Year From",
            "minimum": 1870,
            "maximum": 2030,
            "type": "integer",
            "description": "Only include titles released in or after this year. Leave empty for no lower bound. Applies ONLY when 'Use Advanced Filters' is turned on."
          },
          "releaseYearMax": {
            "title": "Release Year To",
            "minimum": 1870,
            "maximum": 2030,
            "type": "integer",
            "description": "Only include titles released in or before this year. Leave empty for no upper bound. Applies ONLY when 'Use Advanced Filters' is turned on."
          },
          "ratingMin": {
            "title": "Minimum IMDb Rating",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Only include titles with an IMDb rating at or above this value (0–10). Leave empty for no rating filter. Applies ONLY when 'Use Advanced Filters' is turned on."
          },
          "sortBy": {
            "title": "Sort Results By",
            "enum": [
              "popularity",
              "rating",
              "votes",
              "release_date",
              "alpha"
            ],
            "type": "string",
            "description": "Order in which results are collected. Applies ONLY when 'Use Advanced Filters' is turned on — with the checkbox off this field is ignored and the run says so."
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of titles to return per search term or filter set. Set to 0 for as many as available: with Advanced Filters that means every match, up to the 10,000 titles IMDb serves from a single browse, and for a search term it means the 100 most relevant matches per term — one word like 'batman' matches over 11,000 IMDb titles and each one is charged separately. Enter a number to collect exactly that many.",
            "default": 50
          },
          "maxReviewsPerTitle": {
            "title": "User Reviews Per Title",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Also collect up to this many user reviews for each title (capped at 500 per title). Set to 0 to skip reviews (default). Popular titles can have thousands of reviews — keep this low (e.g. 10–50) to control cost, as each review is charged as a result.",
            "default": 0
          },
          "language": {
            "title": "Language",
            "enum": [
              "en",
              "es",
              "fr",
              "de",
              "it",
              "pt",
              "hi",
              "ja",
              "ko",
              "zh"
            ],
            "type": "string",
            "description": "Preferred language for IMDb titles and text where available.",
            "default": "en"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}