{
  "openapi": "3.0.1",
  "info": {
    "title": "Imdb Deep Crawler",
    "description": "One of the fastest and most powerful IMDb web crawlers on Apify. Search, discover, and extract structured IMDb data for titles, people, reviews, episodes, news, trending content, videos, images, and streaming availability from a single actor.",
    "version": "0.0",
    "x-build-id": "d5QL8X2OdCkC25bJ9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/direwolflabs~imdb-deep-crawler/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-direwolflabs-imdb-deep-crawler",
        "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/direwolflabs~imdb-deep-crawler/runs": {
      "post": {
        "operationId": "runs-sync-direwolflabs-imdb-deep-crawler",
        "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/direwolflabs~imdb-deep-crawler/run-sync": {
      "post": {
        "operationId": "run-sync-direwolflabs-imdb-deep-crawler",
        "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": {
          "inputType": {
            "title": "Input type",
            "enum": [
              "",
              "title",
              "person",
              "search",
              "discover",
              "news",
              "trending_titles",
              "trending_trailers",
              "batch_requests"
            ],
            "type": "string",
            "description": "Choose what kind of single input you want to run."
          },
          "requests": {
            "title": "Requests",
            "type": "array",
            "description": "Advanced batch mode. Each request object can contain inputType, titleId, personId, query, filters, mode, and include fields.",
            "items": {
              "type": "object"
            }
          },
          "titleId": {
            "title": "Title ID",
            "type": "string",
            "description": "IMDb title ID for title-based runs, for example tt7286456."
          },
          "personId": {
            "title": "Person ID",
            "type": "string",
            "description": "IMDb person ID for person-based runs, for example nm0000138."
          },
          "query": {
            "title": "Single search query",
            "type": "string",
            "description": "Search term for text search runs."
          },
          "filters": {
            "title": "Single filters object",
            "type": "object",
            "description": "Advanced title search filters as a JSON object. You can also use the separate filter fields below instead of JSON."
          },
          "genre": {
            "title": "Genre",
            "type": "string",
            "description": "Optional genre for title search, for example Action, Comedy, Drama, or Horror."
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Optional language codes for title search, for example en, hi, or fr.",
            "items": {
              "type": "string"
            }
          },
          "minYear": {
            "title": "Minimum year",
            "type": "integer",
            "description": "Optional minimum release year for title search."
          },
          "maxYear": {
            "title": "Maximum year",
            "type": "integer",
            "description": "Optional maximum release year for title search."
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "number",
            "description": "Optional minimum IMDb rating for title search."
          },
          "maxRating": {
            "title": "Maximum rating",
            "type": "number",
            "description": "Optional maximum IMDb rating for title search."
          },
          "titleType": {
            "title": "Title type",
            "type": "string",
            "description": "Optional single title type for title search, for example movie, tvSeries, or tvMovie."
          },
          "titleTypes": {
            "title": "Title types",
            "type": "array",
            "description": "Optional list of multiple title types for title search, for example movie, tvMovie, or tvSpecial.",
            "items": {
              "type": "string"
            }
          },
          "include": {
            "title": "Include",
            "type": "array",
            "description": "Optional include values for the single request input, such as details.",
            "items": {
              "type": "string"
            }
          },
          "pageSize": {
            "title": "Results per page",
            "type": "integer",
            "description": "Number of advanced search titles to request per page.",
            "default": 250
          },
          "maxPages": {
            "title": "Max pages",
            "type": "integer",
            "description": "Maximum number of pages to fetch for advanced search requests."
          },
          "searchLimit": {
            "title": "Search limit",
            "type": "integer",
            "description": "Maximum number of results to keep for text search requests.",
            "default": 20
          },
          "seasonNumber": {
            "title": "Season number",
            "type": "integer",
            "description": "Optional season filter when a title request includes episodes."
          },
          "episodeMaxPages": {
            "title": "Episode max pages",
            "type": "integer",
            "description": "Maximum number of episode pages to fetch when a title request includes episodes."
          },
          "episodePageSize": {
            "title": "Episodes per page",
            "type": "integer",
            "description": "Number of episodes to request per page.",
            "default": 50
          },
          "episodeIncludeExtended": {
            "title": "Episode extended fields",
            "type": "boolean",
            "description": "Include extra episode fields such as genres, certificate, and image dimensions.",
            "default": true
          },
          "streamingCountry": {
            "title": "Streaming country",
            "type": "string",
            "description": "Country code used for streaming availability, for example US.",
            "default": "US"
          },
          "streamingLanguage": {
            "title": "Streaming language",
            "type": "string",
            "description": "Language used for streaming availability, for example en-US.",
            "default": "en-US"
          },
          "videoMaxPages": {
            "title": "Video max pages",
            "type": "integer",
            "description": "Maximum number of video pages to fetch when a title request includes videos."
          },
          "videoPageSize": {
            "title": "Videos per page",
            "type": "integer",
            "description": "Number of videos to request per page.",
            "default": 50
          },
          "includePlaybackUrls": {
            "title": "Include playback URLs",
            "type": "boolean",
            "description": "Include video playback URLs when a title request includes videos.",
            "default": false
          },
          "imageMaxPages": {
            "title": "Image max pages",
            "type": "integer",
            "description": "Maximum number of image pages to fetch when a title request includes images."
          },
          "imagePageSize": {
            "title": "Images per page",
            "type": "integer",
            "description": "Number of images to request per page.",
            "default": 50
          },
          "newsCategory": {
            "title": "News category",
            "enum": [
              "MOVIE",
              "TV",
              "CELEB"
            ],
            "type": "string",
            "description": "Category used when the mode is news.",
            "default": "MOVIE"
          },
          "newsMaxPages": {
            "title": "News max pages",
            "type": "integer",
            "description": "Maximum number of news pages to fetch."
          },
          "newsPageSize": {
            "title": "News per page",
            "type": "integer",
            "description": "Number of news articles to request per page.",
            "default": 25
          },
          "includeNewsPlainText": {
            "title": "Include news plain text",
            "type": "boolean",
            "description": "Include plain text converted from article HTML.",
            "default": false
          },
          "trendingCount": {
            "title": "Trending title count",
            "type": "integer",
            "description": "Number of trending titles to fetch.",
            "default": 10
          },
          "trendingWindow": {
            "title": "Trending window",
            "enum": [
              "HOURS",
              "DAYS",
              "WEEKS"
            ],
            "type": "string",
            "description": "Time window for trending titles.",
            "default": "HOURS"
          },
          "trailerLimit": {
            "title": "Trending trailer limit",
            "type": "integer",
            "description": "Number of trending trailers to fetch.",
            "default": 20
          },
          "reviewMaxPages": {
            "title": "Review max pages",
            "type": "integer",
            "description": "Maximum number of review pages to fetch when a title request includes reviews."
          },
          "reviewSortBy": {
            "title": "Review sort by",
            "enum": [
              "HELPFULNESS_SCORE",
              "SUBMIT_DATE",
              "RATING"
            ],
            "type": "string",
            "description": "How to sort reviews when reviews are included for a title request.",
            "default": "HELPFULNESS_SCORE"
          },
          "reviewSortOrder": {
            "title": "Review sort order",
            "enum": [
              "DESC",
              "ASC"
            ],
            "type": "string",
            "description": "Sort direction for review pages.",
            "default": "DESC"
          },
          "includeRawPage": {
            "title": "Include raw page payload",
            "type": "boolean",
            "description": "If enabled, multi-page records include the raw page response.",
            "default": false
          },
          "failOnError": {
            "title": "Fail on error",
            "type": "boolean",
            "description": "If enabled, the actor stops immediately when a request fails.",
            "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}