EveryData platform API

Douban API

Q: What can I retrieve with the Douban API?

Set `platform` to `douban`. The current catalog lists search, reviews, comments, and group topic. These action names identify different Douban objects or views; they are not interchangeable search modes.

Q: Which fields can Douban `search` return?

Its declared schema includes `title`, `subject_type`, `year`, and `director`. A declared field can still be absent from an individual source record, and every other action has its own field list.

Across Douban, Douban books, films, other catalog items, reviews, comments, and group topics are available through 4 separately documented actions, with `search`, `reviews`, `comments` illustrating the distinct request shapes.

Two early Douban scopes are `search` for matching Douban results, which accepts `keyword`, and `reviews` for review records, which accepts `url`, keeping their objects and fields interpretable.

Start for free View the public catalog

Endpoint: POST /api/v1/social
Capabilities: 4
Per 1,000: $1.389

Available capabilities

Compare the Douban actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.

Action	Required	Optional	Delivery	Limit	Per 1,000	Response fields
`search` Search Use Douban `search` with `keyword` for Douban public results. Use Douban `search` to discover Douban public results. Call Douban `search` with `keyword`, `type`, and `search_type`; Douban `search` exposes `cover_url`, `platform`, `subject_type`, `author`, `id`, `rating_scale`, `director`, `rating`, `year`, `rating_count`, `artist`, `title`, `url`, and `cast`.	keyword	search_type, type	Sync delivery	Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$1.39 per 1,000 requests	id · url · title · subject_type · year · director · cast · author · artist · rating · rating_scale · rating_count · cover_url · platform
`reviews` Reviews Use Douban `reviews` with `url`; Douban then selects review records. For Douban `reviews`, supply `url`; results include `text`, `subject_id`, `subject_type`, `reply_count`, `subject_name`, `rating_scale`, `id`, `author_url`, `rating`, `platform`, `author_avatar_url`, `rating_label`, `author_name`, `posted_at`, `url`, and `title`.	url	—	Sync delivery	Catalog values: defaultLimit=15, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$1.39 per 1,000 requests	id · url · subject_id · subject_name · subject_type · title · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · reply_count · posted_at · platform
`comments` Comments Use `comments` with `url` to retrieve public Douban comments for one target object. Read each row in its parent context instead of inferring an undocumented conversation tree. Pass `url` to Douban `comments`; returned objects expose `author_name`, `posted_at`, `subject_type`, `rating_label`, `rating`, `author_avatar_url`, `platform`, `id`, `subject_id`, `subject_name`, `author_url`, `text`, `vote_count`, and `rating_scale`.	url	—	Sync delivery	Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$1.39 per 1,000 requests	id · subject_id · subject_name · subject_type · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · vote_count · posted_at · platform
`group_topic` Group topic Read one group topic from Douban by setting action to `group_topic`. Use Douban `group_topic` with `url`; Douban then selects one group topic. For Douban `group_topic`, supply `url` and `max_replies`; results include `url`, `group_name`, `text`, `author_url`, `author_name`, `replies`, `group_url`, `posted_at`, `reply_count`, `platform`, `title`, `group_id`, and `id`.	url	max_replies	Sync delivery	Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$1.39 per 1,000 requests	id · url · title · text · group_id · group_name · group_url · author_name · author_url · reply_count · replies · posted_at · platform

What does each Douban action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

What do the Douban `search` parameters mean?

Use Douban search with keyword for Douban public results. Use Douban search to discover Douban public results. Call Douban search with keyword, type, and search_type; Douban search exposes cover_url, platform, subject_type, author, id, rating_scale, director, rating, year, rating_count, artist, title, url, and cast.

keywordRequired: 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_typeOptional: 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
typeOptional: 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
Douban Books: Scope of Book Ratings and ReviewsDouban 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

What do the Douban `reviews` parameters mean?

Use Douban reviews with url; Douban then selects review records. For Douban reviews, supply url; results include text, subject_id, subject_type, reply_count, subject_name, rating_scale, id, author_url, rating, platform, author_avatar_url, rating_label, author_name, posted_at, url, and title.

urlRequired: Specifies the target subject URL formatted as /subject/<ID>/ on movie.douban.com, book.douban.com, or music.douban.com for reviews or comments actions, or as www.douban.com/group/topic/<ID>/ for group_topic. Long reviews, short comments, and group topic replies are handled by separate action endpoints.
Douban Movies: Long Reviews, Short Reviews, and Visibility LimitsDouban Movies explains movie reviews and short reviews separately, noting that the short review section does not show all short reviews and that collapsed content has differing public visibility. Movie review lists returned by this endpoint should not be taken as a complete history or all audience opinions; this source does not replace separate rules for books or music.Checked 2026-09-04

What do the Douban `comments` parameters mean?

Use comments with url to retrieve public Douban comments for one target object. Read each row in its parent context instead of inferring an undocumented conversation tree. Pass url to Douban comments; returned objects expose author_name, posted_at, subject_type, rating_label, rating, author_avatar_url, platform, id, subject_id, subject_name, author_url, text, vote_count, and rating_scale.

urlRequired: Specifies the target subject URL formatted as /subject/<ID>/ on movie.douban.com, book.douban.com, or music.douban.com for reviews or comments actions, or as www.douban.com/group/topic/<ID>/ for group_topic. Long reviews, short comments, and group topic replies are handled by separate action endpoints.
Douban Movies: Long Reviews, Short Reviews, and Visibility LimitsDouban Movies explains movie reviews and short reviews separately, noting that the short review section does not show all short reviews and that collapsed content has differing public visibility. Movie review lists returned by this endpoint should not be taken as a complete history or all audience opinions; this source does not replace separate rules for books or music.Checked 2026-09-04

What do the Douban `group_topic` parameters mean?

Read one group topic from Douban by setting action to group_topic. Use Douban group_topic with url; Douban then selects one group topic. For Douban group_topic, supply url and max_replies; results include url, group_name, text, author_url, author_name, replies, group_url, posted_at, reply_count, platform, title, group_id, and id.

urlRequired: Specifies the target subject URL formatted as /subject/<ID>/ on movie.douban.com, book.douban.com, or music.douban.com for reviews or comments actions, or as www.douban.com/group/topic/<ID>/ for group_topic. Long reviews, short comments, and group topic replies are handled by separate action endpoints.
Douban Groups: Reading Topics Is Distinct from Member ManagementDouban Help lists joining groups, pinning topics, and managing members as distinct features, with certain actions requiring group leader or administrator permissions. Fetching specific topics here and citing management documentation does not grant those permissions, nor does it provide join, post, or management operations.Checked 2026-09-04
max_repliesOptional: Limits the number of topic replies fetched by group_topic per request, accepting integers from 1 to 100 (default 20). Out-of-bounds values are clamped to boundary limits, non-parseable values revert to the default, and returned counts do not guarantee retrieval of all historical replies.

How to use the Douban API

01Read the public catalog and choose a platform action.
02Send the platform, action, and required parameters to POST /api/v1/social.
03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
04Store the structured response fields needed by your application.

douban_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douban","action":"search","params":{"keyword":"<keyword>"}}'

Douban API questions

What can I retrieve with the Douban API?

Set platform to douban. The current catalog lists search, reviews, comments, and group topic. These action names identify different Douban objects or views; they are not interchangeable search modes.

Which input starts a Douban `search` request?

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. Send it as keyword inside params.

Which fields can Douban `search` return?

Its declared schema includes title, subject_type, year, and director. A declared field can still be absent from an individual source record, and every other action has its own field list.

Does every Douban action return immediately?

No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douyin API Dribbble API View the public catalog →