Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Douban: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите фильмы, книги и альбомы на Douban по названию или теме. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Читайте развёрнутые рецензии Douban на фильм, книгу или альбом по ссылке на страницу произведения. | $24 за 1 000 запросовКаждая запись считается одним вызовом API | Норма |
Комментарииcomments | Получите короткие комментарии Douban к фильму, книге или альбому по ссылке на страницу произведения: текст, метку оценки, комментатора, число голосов и дату. | $1.39 за 1 000 запросов | Норма |
Тема группыgroup_topic | Читайте обсуждение в группе Douban по ссылке на тему. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Douban?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите фильмы, книги и альбомы на Douban по названию или теме. Получите год, режиссёра и актёров, автора или исполнителя, рейтинг, число оценивших и обложку. Ограничьте результаты фильмами, книгами или музыкой через | keyword | search_type, type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · subject_type · year · director · cast · author · artist · rating · rating_scale · rating_count · cover_url · platform |
reviewsОтзывы Читайте развёрнутые рецензии Douban на фильм, книгу или альбом по ссылке на страницу произведения. У каждой рецензии есть заголовок, текст, метка оценки, автор и число ответов. Каждая оценка относится к своей рецензии. Выборка не всегда содержит все рецензии на произведение. | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=15, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $24 за 1 000 запросовКаждая запись считается одним вызовом API | 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Комментарии Получите короткие комментарии Douban к фильму, книге или альбому по ссылке на страницу произведения: текст, метку оценки, комментатора, число голосов и дату. Эти короткие комментарии отличаются от развёрнутых рецензий, которые возвращает | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | 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Тема группы Читайте обсуждение в группе Douban по ссылке на тему. Получите первый пост, название группы и ссылку на неё, автора, число ответов и сами ответы. | url | max_replies | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · group_id · group_name · group_url · author_name · author_url · reply_count · replies · posted_at · platform |
Что означают параметры действия search в API Douban?
Ищите фильмы, книги и альбомы на Douban по названию или теме. Получите год, режиссёра и актёров, автора или исполнителя, рейтинг, число оценивших и обложку. Ограничьте результаты фильмами, книгами или музыкой через search_type. Если переданы оба параметра, приоритет у type.
keywordОбязательный- Поисковый запрос по названию или теме для поиска фильмов, книг и музыки на Douban. Полнотекстовый поиск внутри длинных отзывов или тем групп не выполняется.
search_typeНеобязательный- Фильтрует поиск по категории: all (по умолчанию), movie, book или music. Если одновременно передан type, приоритет у type; нераспознанные значения заменяются на all.Допустимые значения:
allbookmoviemusic typeНеобязательный- Переопределяет search_type и фильтрует поиск по категории (all, movie, book или music). Фильтрует только типы записей каталога и не выбирает между reviews (длинными отзывами) и comments (короткими комментариями): это определяется типом действия.Допустимые значения:
allbookmoviemusicDouban Books: что охватывают оценки и рецензии на книги — Douban Books разделяет оценки, полные рецензии и короткие отзывы и рекомендует рассматривать рейтинг книги вместе с другими отзывами. Это объясняет контекст оценок для записи о книге; оценка от этого не становится объективной мерой ценности, а эндпоинт не получает функций, доступных только на сайте. · Проверено
Что означают параметры действия reviews в API Douban?
Читайте развёрнутые рецензии Douban на фильм, книгу или альбом по ссылке на страницу произведения. У каждой рецензии есть заголовок, текст, метка оценки, автор и число ответов. Каждая оценка относится к своей рецензии. Выборка не всегда содержит все рецензии на произведение.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- URL целевой страницы в формате /subject/<ID>/ на movie.douban.com, book.douban.com или music.douban.com для действий reviews и comments либо в формате www.douban.com/group/topic/<ID>/ для group_topic. Длинные отзывы, короткие комментарии и ответы в темах групп обрабатываются отдельными эндпоинтами соответствующих действий.Douban Movies: длинные рецензии, короткие отзывы и ограничения видимости — Douban Movies описывает рецензии и короткие отзывы на фильмы отдельно и отмечает, что в разделе коротких отзывов показаны не все короткие отзывы, а для свёрнутого контента действуют другие правила публичной видимости. Списки рецензий, которые возвращает этот эндпоинт, не следует считать полной историей или совокупностью всех мнений зрителей; этот источник не заменяет отдельных правил для книг и музыки. · Проверено
Что означают параметры действия comments в API Douban?
Получите короткие комментарии Douban к фильму, книге или альбому по ссылке на страницу произведения: текст, метку оценки, комментатора, число голосов и дату. Эти короткие комментарии отличаются от развёрнутых рецензий, которые возвращает reviews.
urlОбязательный- URL целевой страницы в формате /subject/<ID>/ на movie.douban.com, book.douban.com или music.douban.com для действий reviews и comments либо в формате www.douban.com/group/topic/<ID>/ для group_topic. Длинные отзывы, короткие комментарии и ответы в темах групп обрабатываются отдельными эндпоинтами соответствующих действий.Douban Movies: длинные рецензии, короткие отзывы и ограничения видимости — Douban Movies описывает рецензии и короткие отзывы на фильмы отдельно и отмечает, что в разделе коротких отзывов показаны не все короткие отзывы, а для свёрнутого контента действуют другие правила публичной видимости. Списки рецензий, которые возвращает этот эндпоинт, не следует считать полной историей или совокупностью всех мнений зрителей; этот источник не заменяет отдельных правил для книг и музыки. · Проверено
Что означают параметры действия group_topic в API Douban?
Читайте обсуждение в группе Douban по ссылке на тему. Получите первый пост, название группы и ссылку на неё, автора, число ответов и сами ответы. max_replies задаёт число получаемых ответов, от 1 до 100 (по умолчанию 20). Закрытые группы недоступны, а ветка может быть неполной.
urlОбязательный- URL целевой страницы в формате /subject/<ID>/ на movie.douban.com, book.douban.com или music.douban.com для действий reviews и comments либо в формате www.douban.com/group/topic/<ID>/ для group_topic. Длинные отзывы, короткие комментарии и ответы в темах групп обрабатываются отдельными эндпоинтами соответствующих действий.Douban Groups: чтение тем — не то же самое, что управление участниками — В справке Douban вступление в группы, закрепление тем и управление участниками описаны как отдельные функции, и для некоторых действий нужны права руководителя или администратора группы. Получение отдельных тем здесь и ссылки на документацию по управлению не дают этих прав и не добавляют операций вступления, публикации или управления. · Проверено
max_repliesНеобязательный- Ограничивает число ответов в теме, которые group_topic получает за один запрос: целое число от 1 до 100 (по умолчанию 20). Значения вне диапазона приводятся к ближайшей границе, нечисловые значения заменяются значением по умолчанию; возвращённое количество не гарантирует получения всех ответов за всё время.
Как использовать API Douban
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
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>"}}'
Вопросы об API Douban
Какие данные можно получить через API Douban?
Укажите в platform значение douban. В текущем каталоге: поиск, отзывы, комментарии и тема группы. Эти названия действий соответствуют разным объектам или представлениям Douban; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Douban?
Поисковый запрос по названию или теме для поиска фильмов, книг и музыки на Douban. Полнотекстовый поиск внутри длинных отзывов или тем групп не выполняется. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Douban?
Объявленная схема включает title, subject_type, year и director. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Douban возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.