API de Threads
Busca publicaciones y perfiles de Threads, consulta cuentas, posts, comentarios y señales agregadas de seguidores. Usuario, URL y palabra clave identifican recorridos diferentes.
La verificación, los seguidores y las interacciones son datos públicos, no identifican identidad o alcance histórico. Los comentarios pueden ser parciales y no se reconstruyen relaciones inexistentes.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Threads, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar publicaciones en Threadssearch | Busca publicaciones de Threads mediante keyword y devuelve autor, texto e interacciones visibles. | $0.56 por 1.000 solicitudes | Normal |
Consultar un perfil de Threadsprofile | Resuelve un username de Threads y recoge biografía, seguidores y señales públicas de cuenta. | $0.56 por 1.000 solicitudes | Normal |
Listar publicaciones de un usuariouser_posts | Consulta publicaciones públicas del username, diferenciando likes, comentarios y reposts por pieza. | $0.56 por 1.000 solicitudes | Normal |
Consultar una publicación de Threadspost_detail | Abre la url de una publicación concreta y devuelve texto, autor y métricas visibles. | $0.56 por 1.000 solicitudes | Normal |
Leer comentarios de una publicacióncomments | Lee comentarios de la url del post y conserva autor, fecha y referencia de respuesta cuando existe. | $0.56 por 1.000 solicitudes | Normal |
Descubrir perfiles en Threadsdiscover_profiles | Descubre perfiles mediante keyword, con fechas compatibles, y devuelve biografía, seguidores y verificación visible. | $0.56 por 1.000 solicitudes | Normal |
Revisar métricas públicas de seguidoresfollowers | Para el username de Threads, resume follower_count, following_count, publicaciones, likes y la precisión de esos valores (precision). | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿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.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar publicaciones en Threads Busca publicaciones de Threads mediante | 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 |
profileConsultar un perfil de Threads Resuelve un | 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 · external_url |
user_postsListar publicaciones de un usuario Consulta publicaciones públicas del | 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 · media_type · hashtags · mentions |
post_detailConsultar una publicación de Threads Abre la | 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 · media_url · hashtags |
commentsLeer comentarios de una publicación Lee comentarios de la | 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_profilesDescubrir perfiles en Threads Descubre perfiles mediante | 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 · emails · phones · external_links |
followersRevisar métricas públicas de seguidores Para el | 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é 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
searchpara buscar publicaciones públicas ydiscover_profilespara 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ón — 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. · Consultada
¿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_postsofollowers. Puede incluir@. Las accionesprofileyuser_postsno procesan la URL completa del perfil.followersdevuelve 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 Threads — La 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
¿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_postsofollowers. Puede incluir@. Las accionesprofileyuser_postsno procesan la URL completa del perfil.followersdevuelve el número de seguidores, no la lista de seguidores.Meta: localizar publicaciones de Threads por nombre de usuario — La 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
¿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_detailocomments, por ejemplo,https://www.threads.com/@username/post/post_shortcode.commentsno garantiza que se devuelvan todos los niveles de anidación.Meta: republicaciones, citas y contenido compartido fuera de la app en Threads — La 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
¿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_detailocomments, por ejemplo,https://www.threads.com/@username/post/post_shortcode.commentsno garantiza que se devuelvan todos los niveles de anidación.Meta: las respuestas directas no son lo mismo que la conversación completa — La 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. · ConsultadaMeta: se necesitan permisos para leer las respuestas de Threads — La 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
¿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
searchpara buscar publicaciones públicas ydiscover_profilespara 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 clave — La 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 sinceOpcional- Límite inferior de fecha compartido para
discover_profiles. No se garantiza que filtre los perfiles descubiertos; 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.searchno tiene filtro de fecha.
¿Qué significan los parámetros de Threads followers?
Para el username de Threads, resume follower_count, following_count, publicaciones, likes y la precisión de esos valores (precision). No enumera personas ni representa la evolución temporal de la cuenta.
usernameObligatorio- Nombre corto de usuario de Threads para
profile,user_postsofollowers. Puede incluir@. Las accionesprofileyuser_postsno procesan la URL completa del perfil.followersdevuelve 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 Threads — La 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 channelOpcional- Parámetro de cuenta compatible para
followers, con menor prioridad queusername. 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 cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
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>"}}'
Guías de Threads
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Plan de seguimiento de reputación en múltiples plataformas: registra el alcance de la recolección antes de evaluar cambios negativos.
Diseña un proceso de seguimiento de reputación trazable a partir de listas de objetivos, identidades de comentarios y cursores incrementales; usa muestras locales para demostrar la deduplicación y las brechas de recolección, conserva la revisión manual y evita presentar casos de éxito de clientes.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →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 tengan 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.
¿Las acciones de Threads responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.