API de Perfiles en lote 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

Consulta hasta 20 cuentas de Threads a la vez con usernames, cada una como nombre de usuario (con @ o sin ella) o enlace de perfil. Cada cuenta encontrada es una fila con biografía, seguidores, indicadores de verificada y privada, avatar, enlaces de la biografía, temas y vistas públicas, más input, la entrada que enviaste. Se cobra por cuenta; las que no se encuentran no se cobran y salen en missed. Una lista con un duplicado, una entrada no reconocida o más de 20 entradas se rechaza con un 422 antes de cobrar.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a threads y action igual a profiles_batch. Precio $0.56 por 1.000 solicitudes ($0.000556 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Cada elemento de usernames cuenta como una llamada: el número de elementos que envías fija el cobro. Solo síncrona: todo lo que devuelve (cada elemento de un lote o cada SKU de un producto) se lee en esta llamada y "mode": "async" devuelve un 422 antes de cobrar nada.

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Threads: Perfiles en lote (threads/profiles_batch).

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 profiles_batch, y los parámetros dentro de params.
- Parámetros obligatorios:
  - usernames: Cuentas de Threads para profiles_batch, en una lista de hasta 20 entradas; no se admite texto separado por comas.
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.
- Devuelve una lista de registros. Campos principales de cada registro: user_id, username, display_name, bio, follower_count, is_verified, is_private (Si la cuenta es privada), url, avatar_url, external_url (Primer enlace de la biografía), avatar_hd_url (URL del avatar en alta resolución), public_view_count (Vistas públicas de los últimos 30 días,…); 26 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "threads",
  "action": "profiles_batch",
  "params": {
    "usernames": [
      "zuck",
      "mosseri",
      "instagram"
    ]
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Este endpoint solo funciona en modo síncrono; no añadas "mode": "async" al cuerpo.
- 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íprofiles_batchIdentificador de la capacidad, valor fijo.
usernamesbody.paramsarraySí-Cuentas de Threads para profiles_batch, en una lista de hasta 20 entradas; no se admite texto separado por comas. Cada entrada es un nombre de usuario (se quita la @ inicial) o un enlace de perfil, como https://www.threads.com/@mosseri. Cada cuenta solo puede aparecer una vez, aunque cambien las mayúsculas. Si hay una entrada no reconocida, una repetida o más de 20, la petición se rechaza con un 422 antes de cobrar. Se cobra por cuenta; las no encontradas no se cobran y se listan en missed.
limitbody.paramsinteger (1–)No-Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.

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": "profiles_batch",
  "params": {
    "usernames": [
      "zuck",
      "mosseri",
      "instagram"
    ]
  }
}'

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": "profiles_batch",  "results": [    {      "user_id": …,      "username": …,      "display_name": …,      "bio": …,      "follower_count": …,      "is_verified": …,      "is_private": …,      "url": …,      "avatar_url": …,      "platform": …,      "external_url": …,      "avatar_hd_url": …,      "public_view_count": …,      "public_view_count_start": …,      "public_view_count_end": …,      "is_fediverse_enabled": …,      "is_meta_ai_bot": …,      "is_hosting_live_chat": …,      "cover_photo_url": …,      "transparency_label": …,      "bio_links": …,      "bio_mentions": …,      "topics": …,      "bio_links_detail": …,      "topics_detail": …,      "podcast": …,      "input": …    }  ],  "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
user_idIdentificador único del usuario en la plataforma.
usernameNombre de usuario (@usuario).
display_nameNombre visible; puede ser distinto de username.
bioBiografía escrita por la cuenta; puede incluir saltos de línea y emoji.
follower_countSeguidores. null significa no publicado, no 0.
is_verifiedSi la plataforma verificó la cuenta. null significa que no se puede determinar.
is_privateSi la cuenta es privada.
urlEnlace al registro en la plataforma.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
external_urlPrimer enlace de la biografía; no aparece si no hay.
avatar_hd_urlURL del avatar en alta resolución.
public_view_countVistas públicas de los últimos 30 días, el número que Threads muestra públicamente en el perfil; las fechas de inicio y fin del periodo están en public_view_count_start y public_view_count_end.
public_view_count_startFecha de inicio del periodo que cubre public_view_count, YYYY-MM-DD.
public_view_count_endFecha de fin del periodo que cubre public_view_count, YYYY-MM-DD.
is_fediverse_enabledSi la sincronización con el fediverso está activada.
is_meta_ai_botLa cuenta es un bot de Meta AI. Solo aparece cuando es true.
is_hosting_live_chatLa cuenta está organizando un chat en vivo. Solo aparece cuando es true.
cover_photo_urlURL de la foto de portada del perfil.
transparency_labelEtiqueta explicativa que la plataforma añade a la cuenta, p. ej. medio oficial.
bio_linksTodos los enlaces adjuntos en la sección de biografía.
bio_mentionsNombres de usuario mencionados con @ en la biografía.
topicsTemas asociados a la página de perfil de la cuenta.
bio_links_detailTodos los enlaces adjuntos en la sección de biografía, cada uno con url, title (título del enlace; solo algunos lo traen) e is_verified (si se ha verificado la propiedad).
topics_detailTemas asociados al perfil, cada uno con id, name, display_name e is_community.
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).
inputprofiles_batch y posts_batch: la entrada de la petición a la que responde esta fila, devuelta tal como la enviaste.

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