# 豆瓣 API

按书影音类型搜索豆瓣条目，分别读取长评、短评和指定小组话题；短评投票不是评分人数，评论分数与条目评分不混算，也不保证全量讨论。

- Domain: social · 4 data actions
- Canonical page: https://everyinfra.com/douban-api
- Failures and empty results never form a final charge.

## Actions

### search — 关键词搜索
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: keyword

- Optional: search_type, type
- Allowed values: search_type (all/book/movie/music), type (all/book/movie/music)

- Returns fields: id, url, title, subject_type, year, director, cast, author, artist, rating, rating_scale, rating_count, cover_url, platform

### reviews — 评价
- Mode: sync · Price: 1728 credits ($24 / 千次) per row asked
- Required: url

- Returns fields: 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 — 评论
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: 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 — 小组话题
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Optional: max_replies

- Returns fields: id, url, title, text, group_id, group_name, group_url, author_name, author_url, reply_count, replies, posted_at, platform

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md