Douban Search API

Q: How do I search only films or only books?

Set type to movie, book or music, or leave it at all. search_type takes the same values; when both are present type wins, and values outside that list fail parameter validation with a 422 error before the search runs. The filter applies to subjects, not to reviews or comments.

Q: Is a Douban rating out of 5 or 10?

Out of 10, as rating_scale on each row confirms. Divide by rating_scale and multiply by your target scale before you compare with five-star platforms, and check rating_count: a score from a handful of raters can swing widely.

POST

API health

24h health: Normal
24h average time: —

Healthy / normal
Available
Limited
Mostly down

Normal

Last 24 hours

Last 30 days

Look up films, books and albums on Douban by title or topic, with year, director and cast, author or artist, rating, number of raters and cover. Limit results to movies, books or music with search_type; type overrides it when both are sent.

Douban Search finds films, books and music on Douban by keyword and returns each subject's title, type, year, link, cover, Douban rating with its scale and number of raters, and the credits that fit the type: director and cast for films, author for books, artist for music. Use it to see how a title is received on Douban, to find the Douban page for a film, book or album you track, or to build title lists for market research before a release.

Limit results with type: movie, book, music or all. Douban rates on a 10-point scale, so convert with rating_scale before you compare with five-star platforms, and weigh each score by rating_count. keyword matches subject names and topics, not the text of reviews or group posts; reviews are read per subject.

Price $1.39 per 1,000 requests ($0.001389 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

AI prompt

Paste this into your AI assistant. It already holds this endpoint's parameters, response fields and an example request, so the assistant can ask what you need and then write the scraper.

Please help me write a data collection script with the EveryInfra Douban Search endpoint (douban/search).

Endpoint contract:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to douban and action to search, and put the parameters inside params.
- Required parameters:
  - keyword: Specifies the title or topic search query to discover Douban media items across movies, books, and music. Does not perform full-text searching inside long reviews or group topics.
- Optional parameters:
  - search_type: Filters item category discovery using all (default), movie, book, or music. When type is provided simultaneously, type takes precedence; unrecognized values fall back to all. (allowed: all / book / movie / music)
  - type: Overrides search_type to filter item discovery by category (all, movie, book, or music). Filters catalog entry types only and does not select between reviews (long reviews) and comments (short comments), which are govern… (allowed: all / book / movie / music)
  - limit: The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 20)
- Returns a list of records. Main fields of each record: id, url, title, subject_type, year, director, cast, author, artist, rating, rating_scale, rating_count; 13 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douban.
- Example request body:
{
  "platform": "douban",
  "action": "search",
  "params": {
    "keyword": "星际穿越"
  }
}
- Price: $1.39 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

Name	In	Type	Required	Default	Description
`Authorization`	header	`string`	Yes	-	Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
`platform`	body	`string`	Yes	`douban`	Platform identifier, fixed value.
`action`	body	`string`	Yes	`search`	Capability identifier, fixed value.
`keyword`	body.params	Not declared	Yes	-	Specifies the title or topic search query to discover Douban media items across movies, books, and music. Does not perform full-text searching inside long reviews or group topics.
`search_type`	body.params	`enum`	No	-	Filters item category discovery using all (default), movie, book, or music. When type is provided simultaneously, type takes precedence; unrecognized values fall back to all.Allowed values`allbookmoviemusic`
`type`	body.params	`enum`	No	-	Overrides search_type to filter item discovery by category (all, movie, book, or music). Filters catalog entry types only and does not select between reviews (long reviews) and comments (short comments), which are governed by action type.Allowed values`allbookmoviemusic`
`limit`	body.params	`integer (1–50)`	No	`20`	The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge.

Code samples

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douban",
  "action": "search",
  "params": {
    "keyword": "星际穿越"
  }
}'

[OpenAPI definition (JSON)]Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

Field preview

There is no real sample for these example parameters yet: this shows the response shape and fields from the contract, with … as placeholders. It is not the result of a real call.

json

{
  "id": "req_…",
  "platform": "douban",
  "action": "search",
  "results": [
    {
      "id": …,
      "url": …,
      "title": …,
      "subject_type": …,
      "year": …,
      "director": …,
      "cast": …,
      "author": …,
      "artist": …,
      "rating": …,
      "rating_scale": …,
      "rating_count": …,
      "cover_url": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Response fields

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

Field	Meaning
`id`	The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
`url`	Link to the record on the platform.
`title`	Title. null when the platform has no titles (for example text-only posts).
`subject_type`	Keeps the platform's own meaning
`year`	Keeps the platform's own meaning
`director`	Keeps the platform's own meaning
`cast`	Keeps the platform's own meaning
`author`	Keeps the platform's own meaning
`artist`	Keeps the platform's own meaning
`rating`	Rating. The scale varies by platform: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards.
`rating_scale`	Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating.
`rating_count`	Number of people who rated. null means not disclosed, not 0.
`cover_url`	Keeps the platform's own meaning
`platform`	Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

FAQ

How do I search only films or only books?

Set type to movie, book or music, or leave it at all. search_type takes the same values; when both are present type wins, and values outside that list fail parameter validation with a 422 error before the search runs. The filter applies to subjects, not to reviews or comments.

Is a Douban rating out of 5 or 10?

Out of 10, as rating_scale on each row confirms. Divide by rating_scale and multiply by your target scale before you compare with five-star platforms, and check rating_count: a score from a handful of raters can swing widely.

How do I read the reviews of a result?

Douban Reviews reads long reviews and Douban Comments reads short ones; both take a subject page link, a /subject/<ID>/ address on movie.douban.com, book.douban.com or music.douban.com. The url of a search result points to the subject's page on Douban.

Errors and billing

401: Missing or invalid key. Authentication runs before parameter checks, so unauthenticated requests never see the parameter schema.
422: Wrong parameter name or value. The error lists the parameters and allowed values this capability accepts and the closest match; it happens before any charge.
402: Insufficient balance. Top up first.
429: The account's per-minute request limit was reached (all of its API keys count together; a key's own lower limit applies first). Wait for Retry-After and try again; a rate package in the console raises the limit.
503: Could not complete right now. Any charge for the call goes back to your balance automatically, and the billing receipt in the response states the actual outcome, including when it is not yet known. Do not resend blindly.
200 empty: The request completed without data and is not charged (billing.reason = empty_result_refunded).

Official references

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

Douban Books: Scope of Book Ratings and Reviews ↗
Douban Books distinguishes ratings, full reviews, and short reviews, and recommends considering a book’s rating alongside other feedback. This explains the evaluation context for a book entry; it does not make the score an objective measure of value or add website-only features to this endpoint.
Checked 2026-09-04