threads/
profiles

Recopile perfiles públicos de Threads a partir de URL de perfiles compatibles, con identidad normalizada, biografías, imágenes del perfil, sitios web y métricas visibles de la cuenta.

Threads Profiles API

Entrada por URL de perfil
Campos de identidad y sitio web
Métricas visibles de la cuenta
0.6 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Threads Profiles

Los perfiles de Threads son páginas públicas de cuentas con nombres de usuario, nombres visibles, biografías, imágenes de perfil, sitios web y los conteos visibles de seguidores, seguidos y posts. Estos campos de identidad y señales de la cuenta sirven para enriquecer perfiles, comparar cuentas públicas y monitorear su evolución en el tiempo.

Funcionalidades de la Threads Profiles API

  • Lotes de URL de perfiles compatiblesProcesa una o más URL de perfiles de threads.com o threads.net que usen la ruta /@username y rechaza los enlaces de posts y otras rutas que no corresponden.
  • Identidad de perfil normalizadaDevuelve el ID del perfil, la URL, el nombre de usuario, el nombre visible, la biografía, la imagen de perfil y el sitio web vinculado en un registro de perfil coherente.
  • Instantáneas visibles de la cuentaMantiene los conteos disponibles de seguidores, seguidos y posts junto con collected_at, para que cada conjunto de métricas públicas tenga una hora de observación.

Parámetros de la Threads Profiles API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de URL públicas de perfiles de Threads en threads.com o threads.net. Cada ruta debe usar el formato /@username; se rechazan los nombres de usuario sueltos, las URL de posts y otras rutas que no corresponden.

Cómo usar la Threads Profiles API

Envíe URL de perfiles públicos conocidos, siga la tarea asíncrona y lea los registros de perfil normalizados con paginación por cursor.

  1. Prepare una o más URL públicas de perfiles de Threads con la ruta /@username en threads.com o threads.net.
  2. Envíe los enlaces como urls a /v1/threads/profiles y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un fallo.
  4. Lea data.results.items y solicite después el next_cursor devuelto mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/threads/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Threads Profiles API

  • Enriquecimiento de perfiles públicos: Agregue el nombre de usuario, el nombre visible, la biografía, la imagen de perfil, el sitio web y la URL de origen a registros vinculados con perfiles de Threads conocidos.
  • Comparación de la huella de las cuentas: Compare los conteos visibles de seguidores, seguidos y posts entre un conjunto seleccionado de perfiles públicos.
  • Monitoreo de perfiles públicos: Almacene los campos de identidad y las métricas visibles con collected_at para comparar la presentación del perfil y las señales de la cuenta entre distintos momentos de recopilación.

Consejos de expertos para la Threads Profiles API

  • Valide cada URL con la ruta /@username en threads.com o threads.net antes del envío, para que los enlaces de posts y otras rutas que no corresponden no hagan fallar la solicitud.
  • Normalice las URL enviadas y deduplique los perfiles devueltos por id cuando esté disponible, usando url como clave estable alternativa.
  • Trate la biografía, la imagen de perfil, el sitio web y las métricas individuales de la cuenta como campos opcionales, para que los registros públicos parciales sigan siendo utilizables.
  • Mantenga collected_at junto a los conteos de seguidores, seguidos y posts, para que las ejecuciones posteriores se distingan como instantáneas públicas separadas.

Además de la Threads Profiles API, use estas APIs cuando necesite otro tipo de datos públicos de Threads.

  • Threads Posts API — Recolecta desde URLs de publicaciones de Threads compatibles el texto de publicaciones públicas, el contexto del autor, el contenido multimedia, las marcas de tiempo y la interacción visible.
  • Threads User Posts API — Descubre publicaciones públicas desde URLs de perfiles de Threads con un límite por perfil, y devuelve contenido normalizado, autores, contenido multimedia, marcas de tiempo, interacción visible y contexto de origen.
  • Threads Post Replies API — Recolecta las respuestas bajo posts de Threads a partir de sus URL, con texto, autores, conteos de Me gusta y respuestas, contenido multimedia y el ID del post respondido.
  • Threads Search API — Busca en Threads por palabra clave o hashtag los posts destacados, con texto, autores, Me gusta, respuestas, reposts, contenido multimedia y hora de publicación.
  • Threads User Replies API — Recolecta las últimas respuestas públicas que publicó una cuenta a partir de URL de perfiles de Threads, con texto, interacción, contenido multimedia y enlaces.
  • Threads User Reposts API — Recolecta los posts que una cuenta reposteó hace poco a partir de URL de perfiles de Threads, cada uno como el post original con su autor, texto, interacción y contenido multimedia.

Explorar otras plataformas

Combine los datos de Threads con datos públicos de otras plataformas sociales compatibles.

Threads Profiles API — FAQ

Threads Profiles API recupera registros de perfiles públicos a partir de una o más URL de perfiles de Threads compatibles. Devuelve la identidad normalizada, la biografía, la imagen de perfil, el sitio web, los conteos visibles de seguidores, seguidos y posts, y la hora de recopilación.

Envíe una URL HTTP o HTTPS en threads.com, www.threads.com, threads.net o www.threads.net cuya ruta siga la forma /@username. Se rechazan los nombres de usuario sueltos, las URL de posts y otras formas de ruta.

Los resultados pueden incluir el ID del perfil, la URL, el nombre de usuario, el nombre visible, la biografía, la imagen de perfil, el sitio web, los conteos de seguidores, seguidos y posts, y la hora de recopilación.

Es posible que el registro de un perfil público no incluya una biografía, una imagen de perfil, un sitio web o todos los conteos visibles. Los clientes deben aceptar valores opcionales nulos o vacíos.

Cada registro de perfil devuelto cuesta 0.6 créditos de SocQ. Un conjunto de resultados vacío no tiene cargo por resultados.