API de Publicaciones de una tendencia de Threads

POST

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

Lista publicaciones de Threads de una tendencia, a partir de una fila de trending: pasa su keyword y su id como trend_id (también vale el trend.id de una publicación). sort es top (por defecto) o recent. Todas las filas traen trend_info con los datos de la tendencia. Una tendencia que ya salió de la lista puede no devolver publicaciones. Una página de la tendencia no pasa de 10 publicaciones, con independencia de limit. El next_page_token de la respuesta, enviado como page_token, abre la página siguiente; la última no lo incluye.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a threads y action igual a trend_posts. 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.

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Threads: Publicaciones de una tendencia (threads/trend_posts).

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 trend_posts, y los parámetros dentro de params.
- Parámetros obligatorios:
  - keyword: Usa search para buscar publicaciones públicas y discover_profiles para descubrir creadores con palabras clave. En trend_posts es el término de búsqueda de la tendencia, el keyword de una fila de trending.
  - trend_id: ID de la tendencia para trend_posts: el id de una fila de trending o trend.id de una publicación. Cuando una tendencia sale de la lista, puede que ya no se encuentren sus publicaciones.
- Parámetros opcionales:
  - page_token: Token de paginación. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar los demás parámetros. Cada página trae hasta 10 publicaciones y es una llamada; limit no tiene efecto.
  - sort: Orden para topic_posts, location_posts y trend_posts: top para las más populares (por defecto) o recent para las más recientes. (valores admitidos: recent / top)
- Devuelve una lista de registros. Campos principales de cada registro: id, code (Código de la publicación: el tramo del…), url, text, author_username, author_name, author_id, author_avatar_url (URL del avatar del autor), author_is_verified (Si la cuenta del autor tiene la insigni…), author_is_private (Si la cuenta del autor es privada), author_follower_count, like_count; 76 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "threads",
  "action": "trend_posts",
  "params": {
    "keyword": "coffee",
    "trend_id": "1635213951738679"
  }
}
- 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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSíthreadsIdentificador de la plataforma, valor fijo.
actionbodystringSítrend_postsIdentificador de la capacidad, valor fijo.
keywordbody.paramsstringSí-Usa search para buscar publicaciones públicas y discover_profiles para descubrir creadores con palabras clave. En trend_posts es el término de búsqueda de la tendencia, el keyword de una fila de trending. En search_suggest es el texto escrito en el buscador, de hasta 50 caracteres. discover_profiles es una tarea asíncrona; no asumas que el estado de la tarea en la respuesta equivale a la lista de cuentas devuelta.
trend_idbody.paramsstringSí-ID de la tendencia para trend_posts: el id de una fila de trending o trend.id de una publicación. Cuando una tendencia sale de la lista, puede que ya no se encuentren sus publicaciones.
page_tokenbody.paramsstringNo-Token de paginación. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar los demás parámetros. Cada página trae hasta 10 publicaciones y es una llamada; limit no tiene efecto. El token dura 24 horas; la última página no trae next_page_token.
sortbody.paramsstring (enum)No-Orden para topic_posts, location_posts y trend_posts: top para las más populares (por defecto) o recent para las más recientes.Valores permitidosrecenttop

Ejemplos de código

#
bash
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": "trend_posts",
  "params": {
    "keyword": "coffee",
    "trend_id": "1635213951738679"
  }
}'

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

#
Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.
json
{  "id": "req_…",  "platform": "threads",  "action": "trend_posts",  "results": [    {      "id": …,      "code": …,      "url": …,      "text": …,      "author_username": …,      "author_name": …,      "author_id": …,      "author_avatar_url": …,      "author_is_verified": …,      "author_is_private": …,      "author_follower_count": …,      "like_count": …,      "comment_count": …,      "repost_count": …,      "quote_count": …,      "share_count": …,      "posted_at": …,      "media_type": …,      "image_count": …,      "video_count": …,      "media_url": …,      "video_duration_seconds": …,      "topic": …,      "topic_id": …,      "topic_name": …,      "topic_emoji": …,      "topic_is_community": …,      "language": …,      "is_edited": …,      "is_reply": …,      "reply_to_username": …,      "root_post_author_username": …,      "reply_level": …,      "is_pinned": …,      "is_pinned_by_author": …,      "is_spoiler": …,      "reply_control": …,      "counts_hidden": …,      "thread_id": …,      "thread_length": …,      "thread_position": …,      "is_federated": …,      "is_paid_partnership": …,      "ai_label": …,      "text_translation": …,      "attached_text": …,      "fediverse_like_count": …,      "fediverse_reply_count": …,      "is_liked_by_author": …,      "is_collapsed": …,      "reply_approval_enabled": …,      "is_ghost_post": …,      "ghost_expires_at": …,      "is_markup": …,      "hashtags": …,      "mentions": …,      "links": …,      "image_urls": …,      "video_urls": …,      "tagged_users": …,      "media": …,      "link_preview": …,      "location": …,      "quoted_post": …,      "reposted_post": …,      "gif": …,      "music": …,      "podcast": …,      "scorecard": …,      "trend": …,      "author_badge": …,      "custom_like": …,      "platform": …,      "in_reply_to": …,      "reposted_by": …,      "reposted_at": …,      "trend_info": …    }  ],  "next_page_token": …,  "pagination": { … },  "count": …,  "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.

CampoSignificado
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
codeCódigo de la publicación: el tramo del enlace de la publicación que va después de /post/.
urlEnlace al registro en la plataforma.
textTexto 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_usernameNombre de usuario del autor (@usuario), normalmente utilizable en URL.
author_nameNombre visible del autor.
author_idIdentificador único del autor en la plataforma.
author_avatar_urlURL del avatar del autor; enlace firmado que caduca.
author_is_verifiedSi la cuenta del autor tiene la insignia de verificación.
author_is_privateSi la cuenta del autor es privada.
author_follower_countSeguidores del autor. null significa no publicado.
like_countMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
comment_countComentarios. null significa no publicado, no 0.
repost_countRepublicaciones (distintas de las citas). null significa no publicado.
quote_countCitas: cuántas veces otros han citado esta publicación en sus propias publicaciones. null significa no publicado, no 0.
share_countVeces compartido. null significa no publicado, no 0.
posted_atFecha 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.
media_typeTipo de publicación: text (solo texto), image (una imagen), video (un video) o carousel (varias imágenes, o imágenes y videos mezclados).
image_countNúmero de imágenes.
video_countNúmero de videos.
media_urlURL del primer adjunto; enlace firmado que caduca.
video_duration_secondsDuración del primer video, en segundos; la de cada video está en duration_seconds de su entrada de media.
topicNombre interno del tema al que está asociada la publicación, p. ej. bakingthreads; el nombre visible está en topic_name.
topic_idID del tema al que está asociada la publicación.
topic_nameNombre visible del tema, p. ej. Baking Threads.
topic_emojiEmoji del tema (comunidad).
topic_is_communitySi el tema es una comunidad.
languageCódigo de idioma del contenido (por ejemplo zh, en) según la plataforma; puede no ser exacto.
is_editedSi la publicación ha sido editada.
is_replySi esta publicación es una respuesta.
reply_to_usernameNombre de usuario de la persona a quien responde esta publicación; no aparece si no es una respuesta.
root_post_author_usernameNombre de usuario del autor de la publicación principal de esta conversación.
reply_levelNivel de respuesta: 1 es una respuesta directa a la publicación principal, 2 es una respuesta a una respuesta, y así sucesivamente.
is_pinnedSi el autor fijó la publicación en su perfil.
is_pinned_by_authorSolo en respuestas: si el autor de la publicación principal la fijó en la sección de respuestas.
is_spoilerSi la publicación está marcada con una capa de spoiler.
reply_controlQuién puede responder a esta publicación, p. ej. everyone.
counts_hiddenSi el autor ocultó el número de Me gusta y de compartidos; like_count es null cuando están ocultos.
thread_idID del hilo del autor, la serie de publicaciones consecutivas; las publicaciones del mismo hilo comparten este valor.
thread_lengthNúmero de publicaciones del hilo del autor; 1 si la publicación no forma parte de un hilo.
thread_positionPosición de esta publicación dentro del hilo.
is_federatedSi la publicación se sincroniza con el fediverso.
is_paid_partnershipSi la publicación está marcada como colaboración pagada. Sirve para identificar anuncios.
ai_labelCómo está etiquetada la publicación como contenido generado por IA, p. ej. SELF_DISCLOSURE_FLOW (la etiquetó el propio autor); no aparece si no hay.
text_translationTraducción al inglés del texto hecha por Threads; solo aparece cuando el texto no está en inglés y Threads da una traducción.
attached_textTexto completo del adjunto de texto largo de la publicación (el adjunto de texto de Threads).
fediverse_like_countNúmero de Me gusta en el fediverso (Mastodon y otros).
fediverse_reply_countNúmero de respuestas en el fediverso.
is_liked_by_authorSolo en respuestas: si el autor de la publicación principal le dio Me gusta a esta respuesta.
is_collapsedSolo en respuestas: la plataforma colapsó esta respuesta. Solo aparece cuando es true.
reply_approval_enabledEl autor activó la aprobación de respuestas, así que las respuestas necesitan aprobación previa. Solo aparece cuando es true.
is_ghost_postLa publicación es temporal (ghost post) y desaparece automáticamente pasado un tiempo. Solo aparece cuando es true.
ghost_expires_atMomento en que desaparece la publicación temporal.
is_markupLa publicación es un Markup: dibuja o anota sobre la publicación de otra persona. Solo aparece cuando es true.
hashtagsHashtags del texto, en orden de aparición; no aparece si no hay ninguno.
mentionsNombres de usuario mencionados con @ en el texto.
linksEnlaces del texto y enlaces adjuntos a la publicación.
image_urlsLista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes.
video_urlsURL de todos los videos; enlaces firmados que caducan.
tagged_usersNombres de usuario de las personas etiquetadas en las imágenes y videos.
mediaLista de adjuntos, una entrada por adjunto; no aparece si no hay. Cada entrada: type (image o video), url (URL del archivo, enlace firmado que caduca), width y height (píxeles), alt_text (texto alternativo, generado por Threads o escrito por el autor); los videos añaden thumbnail_url (portada), has_audio (si tiene sonido) y duration_seconds (duración en segundos).
link_previewTarjeta de enlace: url, title (título de la tarjeta), description (descripción de la tarjeta), display_url (dominio mostrado), image_url (imagen de la tarjeta) y favicon_url (favicon del sitio).
locationUbicación asociada a la publicación: id (ID de la ubicación), name (nombre de la ubicación) y url (la página de esta ubicación en Threads).
quoted_postLa publicación original que cita esta publicación: id, code, url, text, author_username y posted_at.
reposted_postLa publicación original que esta publicación republica, con la misma estructura que quoted_post.
gifGIF de la publicación: url, webp_url (URL en formato WebP), width y height (ambos en píxeles).
musicMúsica de la publicación: song_id, title (título de la canción), artist (artista), cover_url (portada) y start_ms (milisegundo de la canción en el que empieza la reproducción); no incluye la letra.
podcastEn publicaciones, la tarjeta del episodio de podcast adjunta a la publicación: episode_name, episode_url, podcast_name, platform (plataforma del podcast, p. ej. SPOTIFY, APPLE) e image_url. En profile (datos de la cuenta), el podcast adjunto a la página de perfil: name, url, platform e image_url, y en algunos también links (enlaces de escucha por plataforma, cada uno con platform y url).
scorecardTarjeta de marcador deportivo adjunta a la publicación: status (upcoming: no ha empezado, live: en curso, past: terminado), starts_at (hora de inicio), clock (reloj del partido), period (periodo, p. ej. Q4), home_team y away_team (local y visitante, cada uno con name, short_name, score y logo_url) y url (enlace al pie de la tarjeta).
trendLa tendencia en la que aparece esta publicación: keyword (término de búsqueda de la tendencia), id y summary (resumen escrito por la plataforma; solo algunas lo traen).
author_badgeLa insignia del autor en esta comunidad: type (tipo de insignia, p. ej. MEMBER) y label (etiqueta de identidad que el autor eligió en la comunidad, p. ej. el nombre de un equipo).
custom_likeEstilo de Me gusta personalizado que sustituye al corazón predeterminado en esta publicación: type (EMOJI o STICKER), emoji y sticker_url (URL del GIF del sticker).
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
in_reply_toLa publicación a la que responde esta respuesta: id, code, url, text, author_username, author_name, like_count, comment_count y posted_at.
reposted_byLa cuenta (usuario) que republicó esta publicación; la fila en sí es la publicación original republicada.
reposted_atCuándo se republicó la publicación.
trend_infotrend_posts: la tendencia que pediste, igual en todas las filas: id, keyword, title, summary (escrito por la plataforma), post_count, on_trending_list (si sigue en la lista) y url. title, summary y post_count solo aparecen mientras sigue en la lista.

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.

Errores

Google Analytics solo si aceptas. Privacidad