Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Douban action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | 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. | $1.39 per 1,000 requests | Normal |
Reviewsreviews | Read long-form Douban reviews of a film, book or album from its subject link, with title, text, rating label, reviewer and reply count. | $1.39 per 1,000 requests | Normal |
Commentscomments | List short Douban comments on a film, book or album from its subject link, each with text, rating label, commenter, vote count and date. | $1.39 per 1,000 requests | Normal |
Group topicgroup_topic | Read a Douban group discussion from its topic link, with the opening post, group name and link, author, reply count and the replies themselves. | $1.39 per 1,000 requests | Temporarily unavailable |
Open a capability for its parameters, response fields, code samples and trial.
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.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch 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 | 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 Read long-form Douban reviews of a film, book or album from its subject link, with title, text, rating label, reviewer and reply count. Each rating belongs to its review, and the batch is not necessarily every review of the 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 |
commentsComments List short Douban comments on a film, book or album from its subject link, each with text, rating label, commenter, vote count and date. These brief comments are separate from the long-form write-ups returned by | 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 Read a Douban group discussion from its topic link, with the opening post, group name and link, author, reply count and the replies themselves. | 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 do the Douban search parameters mean?
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.
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 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
What do the Douban reviews parameters mean?
Read long-form Douban reviews of a film, book or album from its subject link, with title, text, rating label, reviewer and reply count. Each rating belongs to its review, and the batch is not necessarily every review of the title.
Full API reference: parameters, code samples, response example and health →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 Limits — Douban 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?
List short Douban comments on a film, book or album from its subject link, each with text, rating label, commenter, vote count and date. These brief comments are separate from the long-form write-ups returned by reviews.
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 Limits — Douban 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?
Read a Douban group discussion from its topic link, with the opening post, group name and link, author, reply count and the replies themselves. max_replies sets how many replies to fetch, from 1 to 100 (default 20); closed groups are out of reach and the thread may be incomplete.
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 Management — Douban 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 action runs asynchronously.
- 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 record, and every other action has its own field list.
Does every Douban action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.