Twitter Profile Scraper
Un perfil de X identifica una cuenta pública mediante su nombre de usuario, nombre visible, biografía, URL del perfil, imágenes, indicadores de estado y contadores visibles. Leídas en conjunto en un momento de recopilación conocido, estas señales ayudan a calificar cuentas, enriquecer directorios y comparar cambios en los perfiles.
Funcionalidades de la Twitter Profile Scraper API
- Resolución de nombre de usuario a perfilResuelve uno o más nombres de usuario públicos de X en la misma recopilación, incluyan o no una @ inicial.
- Identidad, biografía e imágenesCree un registro de cuenta a partir de su ID, nombre de usuario, nombre visible, URL del perfil, biografía, ubicación, avatar, portada y fecha de creación.
- Estado de la cuenta y escala de audienciaCombina las señales de verificación, privacidad, mensajes, post fijado y automatización con los conteos de seguidores, seguidos, posts, contenido multimedia y Me gusta.
- Instantáneas de perfil comparablesMantiene juntos el nombre de usuario enviado, la fecha de creación de la cuenta y collected_at, para que las consultas repetidas sigan siendo rastreables en el tiempo.
Parámetros de la Twitter Profile Scraper API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista obligatoria de nombres de usuario públicos de X. Cada valor puede incluir u omitir una @ inicial. |
Cómo usar la Twitter Profile Scraper API
Prepare primero la lista de cuentas y resuélvala mediante el flujo compartido de tareas asíncronas y resultados con cursor.
- Normalice los nombres de usuario públicos que quiere inspeccionar; la @ inicial es opcional.
- Envíe por POST la lista usernames a /v1/x/profiles y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
- Tras el éxito, almacene data.results.items y use next_cursor mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/x/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@OpenAI"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Twitter Profile Scraper API
- Evaluar cuentas de creadores de contenido y socios: Compare la identidad, la biografía, el estado de verificación y los conteos de audiencia de una lista conocida antes de agregar cuentas a una lista corta.
- Completar directorios de cuentas: Agregue URL de perfiles, nombres visibles, biografías, imágenes, ubicaciones y contadores públicos a registros existentes de CRM o de socios.
- Comparar cambios en los perfiles: Repita las consultas de los mismos ID de cuenta y use collected_at para comparar biografías, señales de estado y conteos de audiencia entre instantáneas.
Consejos de expertos para la Twitter Profile Scraper API
- Elimine la @ inicial y deduplique los nombres de usuario sin distinguir mayúsculas y minúsculas antes de enviar una lista grande de cuentas.
- Almacene id como clave estable de la cuenta y conserve username y extra.input_username para la visualización y para la coincidencia con el origen.
- Asocie cada comparación de conteos de seguidores, posts o contenido multimedia a collected_at, en lugar de tratar los contadores como valores permanentes.
- Permita que las imágenes y las señales de cuenta opcionales sean nulas, para que un perfil público parcial no rompa los registros posteriores.
APIs relacionadas
Además de la Twitter Profile Scraper API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
- X Followers List API — Recolecta las identidades de las cuentas seguidoras públicas y las métricas visibles de sus perfiles para uno o más nombres de usuario de X.
- X Following List API — Recolecta los perfiles seguidos por cuentas públicas de X, incluyendo identidad, biografías, señales de la cuenta, contadores visibles y nombres de usuario de origen.
- X Post Retweeters API — Recolecta, a nivel de tarea, un conjunto único de perfiles públicos normalizados de las cuentas que hicieron repost de URLs de estado conocidas de X o Twitter.
- X Account Location API — Consulta el país donde está ubicada una cuenta, cómo se conecta a X, su fecha de registro y sus cambios de nombre de usuario.
- Twitter Media Scraper API — Recolecta los posts con fotos, videos y GIF de una cuenta, con los archivos multimedia en máxima calidad.
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API