API de plataforma de EveryData

API de Douban

Q: ¿Cómo llamo a la API de Douban?

Envía POST /api/v1/social con `platform` igual a `douban`, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

Q: ¿Qué devuelve la API de Douban?

Devuelve JSON estructurado. Por ejemplo, el esquema de `search` incluye `title`, `subject_type`, `year` y `director`. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.

Q: ¿Qué parámetros son obligatorios?

Depende de la acción. `search` requiere `keyword`; `reviews` requiere `url`; `comments` requiere `url`; consulta las demás acciones en la lista de funciones.

Busca libros, películas, música y otros objetos de Douban y consulta reseñas, comentarios o temas de grupo. El tipo de obra debe conservarse porque autoría, año y escala pueden variar.

Las reseñas extensas y los comentarios breves son colecciones diferentes. Un tema de grupo usa su propia URL y límite de respuestas; ninguna acción accede a grupos cerrados.

Empieza gratis Ver el catálogo público

Endpoint: POST /api/v1/social
Funciones: 4
Por 1.000: 1,389 US$

Funciones disponibles

Compara las acciones de Douban por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

Acción	Obligatorios	Opcionales	Entrega	Límite	Por 1.000	Campos de respuesta
`search` Buscar obras en Douban Busca en Douban por `keyword` y tipo de objeto, separando libro, película o música mediante `search_type` o `type`. Devuelve autoría, año y valoración según la ficha; no mezcla escalas entre categorías.	keyword	search_type, type	Entrega síncrona	El catálogo declara `defaultLimit = 20` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$1.39 por 1.000 solicitudes	id · url · title · subject_type · year · director · cast · author · artist · rating · rating_scale · rating_count · cover_url · platform
`reviews` Leer reseñas extensas de una obra Lee reseñas de la obra indicada por `url`, con título, texto, puntuación y autor. La valoración pertenece a cada reseña y el lote no representa necesariamente todas las opiniones del objeto.	url	—	Entrega síncrona	El catálogo declara `defaultLimit = 15` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$1.39 por 1.000 solicitudes	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` Leer comentarios breves de una obra Obtiene comentarios breves vinculados a la `url` de la obra, con autor, fecha y voto útil cuando existen. No los confunde con reseñas extensas ni reconstruye respuestas que el contrato no declara.	url	—	Entrega síncrona	El catálogo declara `defaultLimit = 20` y `maxLimit = 200` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$1.39 por 1.000 solicitudes	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` Consultar un tema de grupo Consulta por `url` un tema de grupo de Douban y limita respuestas con `max_replies`. Devuelve publicación, grupo y comentarios visibles; no accede a grupos cerrados ni garantiza el hilo completo.	url	max_replies	Entrega síncrona	El catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$1.39 por 1.000 solicitudes	id · url · title · text · group_id · group_name · group_url · author_name · author_url · reply_count · replies · posted_at · platform

¿Qué acepta cada acción de Douban?

Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.

Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.

¿Qué significan los parámetros de Douban `search`?

Busca en Douban por keyword y tipo de objeto, separando libro, película o música mediante search_type o type. Devuelve autoría, año y valoración según la ficha; no mezcla escalas entre categorías.

keywordObligatorio: Nombre o término de búsqueda de una entrada de Douban para encontrar películas, libros o música. No busca en el texto completo de las reseñas largas ni en las publicaciones de los grupos.
search_typeOpcional: Tipo de entrada: all (todas, por defecto), movie (películas), book (libros) o music (música). Si el parámetro type también está presente, este tiene prioridad. Si el tipo no se reconoce, se usará all en su lugar.
Valores permitidos:allbookmoviemusic
typeOpcional: Parámetro con prioridad sobre search_type. Admite all, movie, book o music. Filtra el tipo de entrada, no sirve para alternar entre reseñas largas (reviews) y comentarios cortos (comments); esto último lo determina la action.
Valores permitidos:allbookmoviemusic
Douban: puntuaciones, reseñas y comentarios brevesLa ayuda de Douban Books distingue la puntuación, la reseña extensa y el comentario breve. Esta distinción aporta contexto al resultado, pero no convierte una puntuación en una valoración objetiva ni amplía los tipos de contenido admitidos.Consultada 2026-09-04

¿Qué significan los parámetros de Douban `reviews`?

Lee reseñas de la obra indicada por url, con título, texto, puntuación y autor. La valoración pertenece a cada reseña y el lote no representa necesariamente todas las opiniones del objeto.

urlObligatorio: Para reviews o comments, envía un enlace de una entrada de movie.douban.com, book.douban.com o music.douban.com con el formato /subject/<ID>/. Para group_topic, envía un enlace con el formato www.douban.com/group/topic/<ID>/. Las reseñas largas, los comentarios cortos y las respuestas de grupo son acciones diferentes.
Douban Movie: Reseñas largas, reseñas cortas y alcance de visibilidadDouban Movie distingue entre reseñas de películas y reseñas cortas, aclarando que la sección de reseñas cortas no las muestra todas y que la visibilidad pública del contenido oculto varía. La lista de comentarios de películas que devuelve esta API no debe considerarse como un historial completo ni como la opinión de toda la audiencia; esta fuente no sustituye las reglas específicas para libros o música.Consultada 2026-09-04

¿Qué significan los parámetros de Douban `comments`?

Obtiene comentarios breves vinculados a la url de la obra, con autor, fecha y voto útil cuando existen. No los confunde con reseñas extensas ni reconstruye respuestas que el contrato no declara.

urlObligatorio: Para reviews o comments, envía un enlace de una entrada de movie.douban.com, book.douban.com o music.douban.com con el formato /subject/<ID>/. Para group_topic, envía un enlace con el formato www.douban.com/group/topic/<ID>/. Las reseñas largas, los comentarios cortos y las respuestas de grupo son acciones diferentes.
Douban Movie: Reseñas largas, reseñas cortas y alcance de visibilidadDouban Movie distingue entre reseñas de películas y reseñas cortas, aclarando que la sección de reseñas cortas no las muestra todas y que la visibilidad pública del contenido oculto varía. La lista de comentarios de películas que devuelve esta API no debe considerarse como un historial completo ni como la opinión de toda la audiencia; esta fuente no sustituye las reglas específicas para libros o música.Consultada 2026-09-04

¿Qué significan los parámetros de Douban `group_topic`?

Consulta por url un tema de grupo de Douban y limita respuestas con max_replies. Devuelve publicación, grupo y comentarios visibles; no accede a grupos cerrados ni garantiza el hilo completo.

urlObligatorio: Para reviews o comments, envía un enlace de una entrada de movie.douban.com, book.douban.com o music.douban.com con el formato /subject/<ID>/. Para group_topic, envía un enlace con el formato www.douban.com/group/topic/<ID>/. Las reseñas largas, los comentarios cortos y las respuestas de grupo son acciones diferentes.
Douban Group: Leer temas y gestionar miembros no es lo mismoLa ayuda de Douban clasifica unirse a un grupo, fijar temas y gestionar miembros como funciones distintas; algunas operaciones requieren permisos de creador o administrador. Aquí solo se leen temas específicos; citar las instrucciones de gestión no implica poseer dichos permisos ni ofrece la capacidad de unirse, publicar o administrar.Consultada 2026-09-04
max_repliesOpcional: Número máximo de respuestas que se obtienen por cada tema en group_topic. El valor por defecto es 20 y el rango es de 1 a 100. Los valores fuera de rango se ajustan a los límites; si no se puede interpretar, se usa el valor por defecto. No es el número de temas ni garantiza que se obtengan todas las respuestas del histórico.

Cómo usar la API de Douban

01Consulta el catálogo público y elige una acción de la plataforma.
02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
04Guarda los campos de la respuesta estructurada que necesita tu aplicación.

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>"}}'

Preguntas sobre la API de Douban

¿Cómo llamo a la API de Douban?

Envía POST /api/v1/social con platform igual a douban, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

¿Qué devuelve la API de Douban?

Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, subject_type, year y director. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.

¿Qué matiz de la documentación oficial conviene conservar al usar datos de Douban?

La ayuda de Douban Books distingue la puntuación, la reseña extensa y el comentario breve. Esta distinción aporta contexto al resultado, pero no convierte una puntuación en una valoración objetiva ni amplía los tipos de contenido admitidos.

¿Qué parámetros son obligatorios?

Depende de la acción. search requiere keyword; reviews requiere url; comments requiere url; consulta las demás acciones en la lista de funciones.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douyin API Dribbble API Ver el catálogo público →