API de Republicaciones de una cuenta de Threads
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
Lista las publicaciones que una cuenta de Threads ha republicado, a partir de username (usuario o enlace de perfil). Cada fila es la publicación original, con su texto, autor y contadores, más reposted_by y reposted_at. Recibes hasta 10 republicaciones por llamada y limit se ignora. El next_page_token de cada respuesta es el page_token de la petición siguiente; la última página no lo trae.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a threads y action igual a user_reposts. 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: Republicaciones de una cuenta (threads/user_reposts).
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 user_reposts, y los parámetros dentro de params.
- Parámetros obligatorios:
- username: Nombre corto de usuario de Threads para profile, user_posts, followers, user_replies, user_media, user_reposts, followers_list, following_list y engagement. Puede incluir @.
- 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.
- 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; 75 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Cuerpo de solicitud de ejemplo:
{
"platform": "threads",
"action": "user_reposts",
"params": {
"username": "zuck"
}
}
- 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í | user_reposts | Identificador de la capacidad, valor fijo. |
username | body.params | string | Sí | - | Nombre corto de usuario de Threads para profile, user_posts, followers, user_replies, user_media, user_reposts, followers_list, following_list y engagement. Puede incluir @. Las acciones profile y user_posts no procesan la URL completa del perfil; user_replies, user_media, user_reposts, followers_list, following_list y engagement también aceptan un enlace de perfil como https://www.threads.com/@mosseri. followers devuelve el número de seguidores; para las cuentas en sí usa followers_list y following_list. |
page_token | body.params | string | No | - | 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. |
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": "user_reposts",
"params": {
"username": "zuck"
}
}'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": "user_reposts", "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": … } ], "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.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
code | Código de la publicación: el tramo del enlace de la publicación que va después de /post/. |
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_id | Identificador único del autor en la plataforma. |
author_avatar_url | URL del avatar del autor; enlace firmado que caduca. |
author_is_verified | Si la cuenta del autor tiene la insignia de verificación. |
author_is_private | Si la cuenta del autor es privada. |
author_follower_count | Seguidores del autor. null significa no publicado. |
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 | Citas: cuántas veces otros han citado esta publicación en sus propias publicaciones. null significa no publicado, no 0. |
share_count | Veces compartido. 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. |
media_type | Tipo de publicación: text (solo texto), image (una imagen), video (un video) o carousel (varias imágenes, o imágenes y videos mezclados). |
image_count | Número de imágenes. |
video_count | Número de videos. |
media_url | URL del primer adjunto; enlace firmado que caduca. |
video_duration_seconds | Duración del primer video, en segundos; la de cada video está en duration_seconds de su entrada de media. |
topic | Nombre interno del tema al que está asociada la publicación, p. ej. bakingthreads; el nombre visible está en topic_name. |
topic_id | ID del tema al que está asociada la publicación. |
topic_name | Nombre visible del tema, p. ej. Baking Threads. |
topic_emoji | Emoji del tema (comunidad). |
topic_is_community | Si el tema es una comunidad. |
language | Código de idioma del contenido (por ejemplo zh, en) según la plataforma; puede no ser exacto. |
is_edited | Si la publicación ha sido editada. |
is_reply | Si esta publicación es una respuesta. |
reply_to_username | Nombre de usuario de la persona a quien responde esta publicación; no aparece si no es una respuesta. |
root_post_author_username | Nombre de usuario del autor de la publicación principal de esta conversación. |
reply_level | Nivel de respuesta: 1 es una respuesta directa a la publicación principal, 2 es una respuesta a una respuesta, y así sucesivamente. |
is_pinned | Si el autor fijó la publicación en su perfil. |
is_pinned_by_author | Solo en respuestas: si el autor de la publicación principal la fijó en la sección de respuestas. |
is_spoiler | Si la publicación está marcada con una capa de spoiler. |
reply_control | Quién puede responder a esta publicación, p. ej. everyone. |
counts_hidden | Si el autor ocultó el número de Me gusta y de compartidos; like_count es null cuando están ocultos. |
thread_id | ID del hilo del autor, la serie de publicaciones consecutivas; las publicaciones del mismo hilo comparten este valor. |
thread_length | Número de publicaciones del hilo del autor; 1 si la publicación no forma parte de un hilo. |
thread_position | Posición de esta publicación dentro del hilo. |
is_federated | Si la publicación se sincroniza con el fediverso. |
is_paid_partnership | Si la publicación está marcada como colaboración pagada. Sirve para identificar anuncios. |
ai_label | Có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_translation | Traducció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_text | Texto completo del adjunto de texto largo de la publicación (el adjunto de texto de Threads). |
fediverse_like_count | Número de Me gusta en el fediverso (Mastodon y otros). |
fediverse_reply_count | Número de respuestas en el fediverso. |
is_liked_by_author | Solo en respuestas: si el autor de la publicación principal le dio Me gusta a esta respuesta. |
is_collapsed | Solo en respuestas: la plataforma colapsó esta respuesta. Solo aparece cuando es true. |
reply_approval_enabled | El autor activó la aprobación de respuestas, así que las respuestas necesitan aprobación previa. Solo aparece cuando es true. |
is_ghost_post | La publicación es temporal (ghost post) y desaparece automáticamente pasado un tiempo. Solo aparece cuando es true. |
ghost_expires_at | Momento en que desaparece la publicación temporal. |
is_markup | La publicación es un Markup: dibuja o anota sobre la publicación de otra persona. Solo aparece cuando es true. |
hashtags | Hashtags del texto, en orden de aparición; no aparece si no hay ninguno. |
mentions | Nombres de usuario mencionados con @ en el texto. |
links | Enlaces del texto y enlaces adjuntos a la publicación. |
image_urls | Lista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes. |
video_urls | URL de todos los videos; enlaces firmados que caducan. |
tagged_users | Nombres de usuario de las personas etiquetadas en las imágenes y videos. |
media | Lista 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_preview | Tarjeta 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). |
location | Ubicació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_post | La publicación original que cita esta publicación: id, code, url, text, author_username y posted_at. |
reposted_post | La publicación original que esta publicación republica, con la misma estructura que quoted_post. |
gif | GIF de la publicación: url, webp_url (URL en formato WebP), width y height (ambos en píxeles). |
music | Mú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. |
podcast | En 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). |
scorecard | Tarjeta 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). |
trend | La 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_badge | La 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_like | Estilo 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). |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
in_reply_to | La publicación a la que responde esta respuesta: id, code, url, text, author_username, author_name, like_count, comment_count y posted_at. |
reposted_by | La cuenta (usuario) que republicó esta publicación; la fila en sí es la publicación original republicada. |
reposted_at | Cuándo se republicó la publicación. |
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.