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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista 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.
- Prepare una o más URL públicas de perfiles de Threads con la ruta /@username en threads.com o threads.net.
- Envíe los enlaces como urls a /v1/threads/profiles y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un fallo.
- 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 trueCasos 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.
APIs relacionadas
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.