API de Publicaciones de un lugar 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 etiquetadas con un lugar, a partir de location_id, el valor de location.id en las publicaciones que devuelven otras acciones. name es opcional y sort es top (por defecto) o recent. Cada fila es una publicación y todas traen location_info (id, name) con el lugar pedido. Por cada llamada llegan hasta 10 publicaciones del lugar, y limit no cambia ese máximo. Para seguir leyendo, copia el next_page_token recibido en page_token; en la última página ya no aparece.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a threads y action igual a location_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 un lugar (threads/location_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 location_posts, y los parámetros dentro de params.
- Parámetros obligatorios:
  - location_id: ID del lugar para location_posts: el id dentro de location en una publicación que devuelve otra acción.
- Parámetros opcionales:
  - name: Nombre del lugar para location_posts. Opcional.
  - 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": "location_posts",
  "params": {
    "location_id": "1095776834684111"
  }
}
- 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ílocation_postsIdentificador de la capacidad, valor fijo.
location_idbody.paramsstringSí-ID del lugar para location_posts: el id dentro de location en una publicación que devuelve otra acción.
namebody.paramsstringNo-Nombre del lugar para location_posts. Opcional.
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": "location_posts",
  "params": {
    "location_id": "1095776834684111"
  }
}'

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": "location_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": …,      "location_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.
location_infolocation_posts: el lugar que pediste, igual en todas las filas: id y name.

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