API de plataforma de EveryData

API de Threads

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

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

Q: ¿Qué devuelve la API de Threads?

Devuelve JSON estructurado. Por ejemplo, el esquema de `search` incluye `text`, `author_name`, `author_username` y `author_id`. 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`; `profile` requiere `username`; `user_posts` requiere `username`; consulta las demás acciones en la lista de funciones.

Busca publicaciones y perfiles de Threads, consulta cuentas, posts, comentarios y señales agregadas de seguidores. Usuario, URL y palabra clave identifican recorridos diferentes.

Verificación, seguidores e interacciones son señales públicas, no identidad o alcance histórico. Los comentarios pueden ser parciales y no se reconstruyen relaciones inexistentes.

Empieza gratis Ver el catálogo público

Endpoint: POST /api/v1/social
Funciones: 7
Por 1.000: 0,556 US$

Funciones disponibles

Compara las acciones de Threads 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 publicaciones en Threads Busca publicaciones de Threads mediante `keyword` y devuelve autor, texto e interacciones visibles. No busca perfiles por nombre ni promete cobertura histórica o en tiempo real.	keyword	—	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.	$0.56 por 1.000 solicitudes	id · url · text · author_name · author_username · author_id · like_count · comment_count · posted_at · platform
`profile` Consultar un perfil de Threads Resuelve un `username` de Threads y recoge biografía, seguidores y señales públicas de cuenta. No accede a perfiles privados ni verifica identidad por cuenta propia.	username	—	Entrega síncrona	—	$0.56 por 1.000 solicitudes	user_id · username · display_name · bio · follower_count · is_verified · is_private · url · avatar_url · platform
`user_posts` Listar publicaciones de un usuario Consulta publicaciones públicas del `username`, diferenciando likes, comentarios y reposts por pieza. El lote no garantiza todo el historial ni incluye automáticamente respuestas.	username	—	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.	$0.56 por 1.000 solicitudes	id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · platform
`post_detail` Consultar una publicación de Threads Abre la `url` de una publicación concreta y devuelve texto, autor y métricas visibles. No incorpora el hilo completo ni acciones de edición o republicación.	url	—	Entrega síncrona	—	$0.56 por 1.000 solicitudes	id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · is_paid_partnership · platform
`comments` Leer comentarios de una publicación Lee comentarios de la `url` del post y conserva autor, fecha y referencia de respuesta cuando existe. No publica ni reconstruye necesariamente todo el árbol.	url	—	Entrega síncrona	—	$0.56 por 1.000 solicitudes	id · url · text · author_username · author_name · author_is_verified · like_count · comment_count · reply_to · posted_at · platform
`discover_profiles` Descubrir perfiles en Threads Descubre perfiles mediante `keyword`, con fechas compatibles, y devuelve biografía, seguidores y verificación visible. La coincidencia no prueba identidad ni afinidad.	keyword	since, until	Entrega así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.	$0.56 por 1.000 solicitudes	username · display_name · bio · follower_count · is_verified · url · avatar_url · platform
`followers` Revisar métricas públicas de seguidores Para el `username` de Threads, resume `follower_count`, `following_count`, publicaciones, likes y la precisión que entregue la ruta compatible con `channel`. No enumera personas ni representa la evolución temporal de la cuenta.	username	channel	Entrega síncrona	—	$0.56 por 1.000 solicitudes	id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform

¿Qué acepta cada acción de Threads?

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 Threads `search`?

Busca publicaciones de Threads mediante keyword y devuelve autor, texto e interacciones visibles. No busca perfiles por nombre ni promete cobertura histórica o en tiempo real.

keywordObligatorio: Usa search para buscar publicaciones públicas y discover_profiles para descubrir creadores con palabras clave. Esta última es una tarea asíncrona; no asumas que el estado de la tarea en la respuesta equivale a la lista de cuentas devuelta.
Threads: descubrimiento por palabra y métricas de interacciónMeta documenta el descubrimiento de publicaciones públicas por término y diferencia respuestas, reposts, quotes y compartidos fuera de la aplicación. Esa terminología no añade escritura, analítica o filtros oficiales al contrato de EveryInfra.Consultada 2026-09-04

¿Qué significan los parámetros de Threads `profile`?

Resuelve un username de Threads y recoge biografía, seguidores y señales públicas de cuenta. No accede a perfiles privados ni verifica identidad por cuenta propia.

usernameObligatorio: Nombre corto de usuario de Threads para profile, user_posts o followers. Puede incluir @. Las acciones profile y user_posts no procesan la URL completa del perfil. followers devuelve el número de seguidores, no la lista de seguidores.
Meta: significado y límites de acceso a los perfiles y recuentos de seguidores de ThreadsLa documentación oficial define `username`, nombre de visualización, biografía (`bio`) y `follower_count`. El acceso a perfiles públicos requiere permisos específicos; el acceso estándar está limitado a ciertas cuentas oficiales, y el texto detalla restricciones como umbrales de seguidores. Esta referencia se usa para explicar la terminología, sin afirmar que este servicio posea dichos permisos o tenga el mismo alcance que la API oficial.Consultada 2026-09-04

¿Qué significan los parámetros de Threads `user_posts`?

Consulta publicaciones públicas del username, diferenciando likes, comentarios y reposts por pieza. El lote no garantiza todo el historial ni incluye automáticamente respuestas.

usernameObligatorio: Nombre corto de usuario de Threads para profile, user_posts o followers. Puede incluir @. Las acciones profile y user_posts no procesan la URL completa del perfil. followers devuelve el número de seguidores, no la lista de seguidores.
Meta: localizar publicaciones de Threads por nombre de usuarioLa documentación oficial distingue entre los puntos de acceso al perfil de usuario y a sus publicaciones. El punto `profile_posts` localiza contenido con un `username` exacto y detalla campos como `id`, `shortcode` y `permalink`. Los parámetros oficiales como `access_token`, paginación o fechas no deben considerarse capacidades soportadas por esta API.Consultada 2026-09-04

¿Qué significan los parámetros de Threads `post_detail`?

Abre la url de una publicación concreta y devuelve texto, autor y métricas visibles. No incorpora el hilo completo ni acciones de edición o republicación.

urlObligatorio: Enlace completo de la publicación para post_detail o comments, por ejemplo, https://www.threads.com/@username/post/post_shortcode. Actualmente, comments no garantiza que se devuelvan todos los niveles de anidación.
Meta: republicaciones, citas y contenido compartido fuera de la app en ThreadsLa documentación oficial distingue entre `reposts`, `quotes` y `shares`, y explica que `shares` se refiere a contenido compartido fuera de la aplicación. Sirve únicamente para interpretar las métricas de interacción de la publicación original, sin que ello garantice que esta API devuelva siempre todos los indicadores o que pueda ejecutar acciones de publicación.Consultada 2026-09-04

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

Lee comentarios de la url del post y conserva autor, fecha y referencia de respuesta cuando existe. No publica ni reconstruye necesariamente todo el árbol.

urlObligatorio: Enlace completo de la publicación para post_detail o comments, por ejemplo, https://www.threads.com/@username/post/post_shortcode. Actualmente, comments no garantiza que se devuelvan todos los niveles de anidación.
Meta: las respuestas directas no son lo mismo que la conversación completaLa documentación oficial distingue entre las respuestas de primer nivel (`replies`) y la conversación completa sin límite de anidación (`conversation`), y define `replied_to` como el ID del contenido padre directo. El campo `reply_to` de esta API es actualmente el nombre del usuario respondido, lo que no equivale al `replied_to` oficial ni garantiza el árbol de respuestas completo. La documentación oficial también menciona restricciones de visibilidad y derechos de autor que pueden causar la omisión de campos.Consultada 2026-09-04
Meta: se necesitan permisos para leer las respuestas de ThreadsLa documentación oficial sobre gestión de respuestas se centra en las publicaciones del propio usuario y requiere un `access_token` con los permisos de lectura adecuados. Esta referencia no garantiza el acceso a las respuestas de publicaciones de terceros ni demuestra que este producto haya obtenido una autorización de la plataforma.Consultada 2026-09-04

¿Qué significan los parámetros de Threads `discover_profiles`?

Descubre perfiles mediante keyword, con fechas compatibles, y devuelve biografía, seguidores y verificación visible. La coincidencia no prueba identidad ni afinidad.

keywordObligatorio: Usa search para buscar publicaciones públicas y discover_profiles para descubrir creadores con palabras clave. Esta última es una tarea asíncrona; no asumas que el estado de la tarea en la respuesta equivale a la lista de cuentas devuelta.
Meta: el descubrimiento de perfiles públicos no es una búsqueda precisa de personas por palabra claveLa función oficial `profile_lookup` requiere un nombre de usuario exacto y está sujeta a permisos, niveles de acceso y condiciones de la cuenta. Por tanto, la búsqueda de candidatos por `keyword` de este servicio no puede equipararse a la consulta precisa oficial, y mucho menos prometer una cobertura de todos los usuarios basándose en la documentación de la plataforma.Consultada 2026-09-04
sinceOpcional: Límite inferior de fecha compartido para discover_profiles. No se ha confirmado si el modo de descubrimiento actual aplica esta condición; no lo uses como filtro por fecha de registro de la cuenta.
untilOpcional: Límite superior de fecha compartido para discover_profiles. No se garantiza que se obtengan todos los autores de ese período. La ruta principal de search no ofrece un filtro de fecha equivalente.

¿Qué significan los parámetros de Threads `followers`?

Para el username de Threads, resume follower_count, following_count, publicaciones, likes y la precisión que entregue la ruta compatible con channel. No enumera personas ni representa la evolución temporal de la cuenta.

usernameObligatorio: Nombre corto de usuario de Threads para profile, user_posts o followers. Puede incluir @. Las acciones profile y user_posts no procesan la URL completa del perfil. followers devuelve el número de seguidores, no la lista de seguidores.
Meta: significado y límites de acceso a los perfiles y recuentos de seguidores de ThreadsLa documentación oficial define `username`, nombre de visualización, biografía (`bio`) y `follower_count`. El acceso a perfiles públicos requiere permisos específicos; el acceso estándar está limitado a ciertas cuentas oficiales, y el texto detalla restricciones como umbrales de seguidores. Esta referencia se usa para explicar la terminología, sin afirmar que este servicio posea dichos permisos o tenga el mismo alcance que la API oficial.Consultada 2026-09-04
channelOpcional: Parámetro de cuenta compatible para followers, con menor prioridad que username. Se usa para leer el número de seguidores, no para obtener una lista de canales o miembros de un grupo de Threads.

Cómo usar la API de Threads

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.

threads_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":"threads","action":"search","params":{"keyword":"<keyword>"}}'

Preguntas sobre la API de Threads

¿Cómo llamo a la API de Threads?

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

¿Qué devuelve la API de Threads?

Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye text, author_name, author_username y author_id. 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 Threads?

Meta documenta el descubrimiento de publicaciones públicas por término y diferencia respuestas, reposts, quotes y compartidos fuera de la aplicación. Esa terminología no añade escritura, analítica o filtros oficiales al contrato de EveryInfra.

¿Qué parámetros son obligatorios?

Depende de la acción. search requiere keyword; profile requiere username; user_posts requiere username; consulta las demás acciones en la lista de funciones.

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