API de Detalles de la publicación de Threads
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
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.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a threads y action igual a post_detail. Precio $0.56 por 1.000 solicitudes ($0.000556 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.
Threads Detalles de la publicación lee una publicación concreta de Threads a partir de su url y devuelve el texto completo, el código corto, el autor con su nombre de usuario, nombre visible y verificación, los me gusta, comentarios, republicaciones, citas, veces compartida y visualizaciones, la fecha de publicación y si está marcada como colaboración pagada. Sirve para comprobar cómo funcionó una publicación concreta, citar con exactitud lo que dijo una cuenta y cuándo, o actualizar las cifras de enlaces reunidos en un informe de campaña.
repost_count y quote_count miden cosas distintas: el primero cuenta las republicaciones y el segundo las citas, en las que otra cuenta añade su propio texto. is_paid_partnership permite separar el contenido patrocinado del orgánico cuando mides una campaña. Un view_count o un share_count en null significa que la cifra no se publicó, no que sea cero. La respuesta trae la publicación indicada, no el hilo completo.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Threads: Detalles de la publicación (threads/post_detail).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en threads y action en post_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
- url: Enlace completo de la publicación para post_detail o comments, por ejemplo, https://www.threads.com/@username/post/post_shortcode. comments no garantiza que se devuelvan todos los niveles de anidación.
- Devuelve un objeto. Campos principales: id, code, url, text, author_username, author_name, author_is_verified, like_count, comment_count, repost_count, quote_count, share_count; 21 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Cuerpo de solicitud de ejemplo:
{
"platform": "threads",
"action": "post_detail",
"params": {
"url": "https://www.threads.com/@openai/post/DW7RXR7EnRC"
}
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | threads | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | post_detail | Identificador de la capacidad, valor fijo. |
url | body.params | string | Sí | - | Enlace completo de la publicación para post_detail o comments, por ejemplo, https://www.threads.com/@username/post/post_shortcode. comments no garantiza que se devuelvan todos los niveles de anidación. |
Ejemplos de código
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "threads",
"action": "post_detail",
"params": {
"url": "https://www.threads.com/@openai/post/DW7RXR7EnRC"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Ejemplo de respuesta
#{ "id": "req_…", "platform": "threads", "action": "post_detail", "results": { "url": "https://www.threads.com/@openai/post/DW7RXR7EnRC", "text": "Aw shit MIGHT have to downgrade Claude for that 10x plus. @openai help convince me haha. Make it irrefutable", "author_username": "•••", "author_name": "•••", "author_is_verified": true, "like_count": 5, "comment_count": 0, "repost_count": 0, "quote_count": 0, "posted_at": "2026-04-09T21:37:07+00:00", "is_paid_partnership": false, "platform": "threads" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
code | Conserva el significado de la plataforma |
url | Enlace al registro en la plataforma. |
text | Texto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma). |
author_username | Nombre de usuario del autor (@usuario), normalmente utilizable en URL. |
author_name | Nombre visible del autor. |
author_is_verified | Conserva el significado de la plataforma |
like_count | Me gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0. |
comment_count | Comentarios. null significa no publicado, no 0. |
repost_count | Republicaciones (distintas de las citas). null significa no publicado. |
quote_count | Conserva el significado de la plataforma |
share_count | Veces compartido. null significa no publicado, no 0. |
view_count | Visualizaciones o reproducciones. null significa no publicado, no 0. |
posted_at | Fecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica. |
is_paid_partnership | Conserva el significado de la plataforma |
author_id | Identificador único del autor en la plataforma. |
author_avatar_url | Conserva el significado de la plataforma |
image_count | Conserva el significado de la plataforma |
image_urls | Lista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
media_url | Conserva el significado de la plataforma |
hashtags | Hashtags del texto, en orden de aparición; no aparece si no hay ninguno. |
Preguntas frecuentes
#¿Qué enlace tengo que enviar en url?
#El enlace completo de la publicación, con la forma https://www.threads.com/@usuario/post/código, por ejemplo https://www.threads.com/@openai/post/DW7RXR7EnRC. Cópialo de la barra de direcciones con la publicación abierta. El enlace de un perfil no sirve, porque no identifica una publicación concreta.
¿Cómo leo los comentarios de la publicación?
#Pasa la misma url a Threads Comentarios, que lista las respuestas a esa publicación. En esta ficha, comment_count te dice cuántos comentarios tiene, lo que te ayuda a decidir si merece la pena hacer esa segunda llamada. Así puedes reservar la lectura de comentarios para las publicaciones con más conversación.
¿Cómo distingo una publicación patrocinada?
#Mira is_paid_partnership: vale true cuando la publicación está marcada como colaboración pagada. Úsalo para separar el contenido patrocinado del orgánico al comparar resultados, por ejemplo al medir una campaña con creadores, ya que mezclar ambos tipos distorsiona las medias de me gusta y visualizaciones.
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Referencias oficiales
#Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.
- 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.
Comprobado el 2026-09-04