{
  "openapi": "3.0.1",
  "info": {
    "title": "Douban Reviews Scraper - Movies, Books, TV & Groups",
    "description": "Get Douban reviews for any movie, TV show, book or album with the full review text, star rating, useful votes, author and date, plus short comments (短评), group topics and search results. No login. $25 per 1,000 reviews, $4 per 1,000 comments; title details and errors are free.",
    "version": "1.0",
    "x-build-id": "V0msm6AzaSPTwZPvJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tenfoldfleet~douban-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tenfoldfleet-douban-reviews-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/tenfoldfleet~douban-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tenfoldfleet-douban-reviews-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/tenfoldfleet~douban-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tenfoldfleet-douban-reviews-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": {
          "urls": {
            "title": "Douban URLs or ids",
            "type": "array",
            "description": "Movie, TV, book or music pages (movie.douban.com/subject/1292052, book.douban.com/subject/1007305), single reviews (movie.douban.com/review/1000369), group topics (www.douban.com/group/topic/...) or whole groups (www.douban.com/group/248952). Mobile m.douban.com links and bare numeric ids also work. Free Apify plan: up to 50 paid results per run.",
            "items": {
              "type": "string"
            }
          },
          "maxReviewsPerSubject": {
            "title": "Max reviews per title",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Long reviews (影评/书评) to fetch per movie, show, book or album, most helpful first, each with its full text. Douban shows about 40 reviews per title to visitors without an account; that is the practical ceiling. 0 = skip reviews.",
            "default": 20
          },
          "maxCommentsPerSubject": {
            "title": "Max short comments per title",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Short comments (短评) with star ratings to fetch per title, most popular first. Douban shows about 120 per status without an account. 0 = skip comments.",
            "default": 0
          },
          "commentStatuses": {
            "title": "Comment status",
            "type": "array",
            "description": "Which short comments to fetch: done = watched/read/listened (看过), mark = want to (想看), doing = in progress (在看). Each status has its own pool of about 120.",
            "items": {
              "type": "string",
              "enum": [
                "done",
                "mark",
                "doing"
              ],
              "enumTitles": [
                "Watched / read (看过)",
                "Want to (想看)",
                "In progress (在看)"
              ]
            },
            "default": [
              "done"
            ]
          },
          "includeSubjectDetails": {
            "title": "Add title details (free)",
            "type": "boolean",
            "description": "Add one free row per title with its Douban rating, rating count, genres, directors, cast or authors, release dates and synopsis. If you ask for no reviews and no comments, at most 20 titles are processed per run.",
            "default": true
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Optional. Search Douban by name (Chinese or English), e.g. 肖申克的救赎 or Inception. Each result is one row.",
            "items": {
              "type": "string"
            }
          },
          "searchType": {
            "title": "Search in",
            "enum": [
              "movie",
              "book",
              "music"
            ],
            "type": "string",
            "description": "What to search. Movies includes TV shows.",
            "default": "movie"
          },
          "maxSearchResults": {
            "title": "Max results per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many search results to return per query.",
            "default": 20
          },
          "scrapeTopSearchResults": {
            "title": "Scrape reviews of top search results",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Also fetch reviews and comments for the first N results of each search, as if their URLs were in the list above. 0 = search results only.",
            "default": 0
          },
          "maxTopicsPerGroup": {
            "title": "Max topics per group",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "For group URLs: how many recent topics to fetch, each with its full text.",
            "default": 20
          },
          "maxRepliesPerTopic": {
            "title": "Max replies per topic",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Replies to fetch under each group topic. 0 = topic text only.",
            "default": 0
          },
          "defaultSubjectType": {
            "title": "Type of bare ids",
            "enum": [
              "movie",
              "book",
              "music"
            ],
            "type": "string",
            "description": "What a bare numeric id in the URL list is. TV ids work as movie ids.",
            "default": "movie"
          },
          "maxConcurrency": {
            "title": "Parallel sessions",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Proxy sessions working in parallel. Each sends at most one request every 1-2 seconds to stay polite.",
            "default": 3
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Default: Apify datacenter proxy with a fresh IP per session, residential only as a last retry. Free Apify plan: up to 50 paid results per run.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}