EveryData platform API
Douban API
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.
- 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 |
|---|---|---|---|---|---|---|
searchSearch Search public results on Douban. Accepts these parameters: | 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 |
reviewsReviews Retrieve public reviews from Douban. Accepts these parameters: | 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 |
commentsComments Retrieve public comments from Douban. Accepts these parameters: | 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_topicGroup topic Use the | 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?
Search public results on Douban. Accepts these parameters: keyword, type, and search_type. Returns these fields: cover_url, subject_type, author, and rating_scale.
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:
allbookmoviemusicDouban 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
What do the Douban reviews parameters mean?
Retrieve public reviews from Douban. Accepts these parameters: url. Returns these fields: text, subject_id, subject_type, and reply_count.
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
What do the Douban comments parameters mean?
Retrieve public comments from Douban. Accepts these parameters: url. Returns these fields: author_name, posted_at, subject_type, and rating_label.
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
What do the Douban group_topic parameters mean?
Use the group_topic action on Douban. Accepts these parameters: url and max_replies. Returns these fields: group_name, text, author_url, and author_name.
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
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.
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.