x/
profiles

Convierta uno o más nombres de usuario públicos de X en registros de perfil con identidad, biografía, recursos visuales, estado de la cuenta, conteos visibles de audiencia y hora de recopilación.

Twitter Profile Scraper API

Identidad del perfil
Conteos de audiencia
Instantáneas de 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

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ámetrosObligatorioDescripción
usernamesObligatorioLista 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.

  1. Normalice los nombres de usuario públicos que quiere inspeccionar; la @ inicial es opcional.
  2. Envíe por POST la lista usernames a /v1/x/profiles y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

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

Twitter Profile Scraper API — FAQ

Twitter Profile Scraper API recupera registros de perfiles públicos de X para uno o más nombres de usuario. Devuelve la identidad de la cuenta, la biografía, las imágenes, las señales de estado, los conteos visibles de audiencia y la hora de recopilación.

Envíe uno o más identificadores públicos en la lista usernames. Se aceptan tanto nasa como @nasa, y los valores duplicados se normalizan antes de la recopilación.

Un registro puede contener el ID de la cuenta, el nombre de usuario, el nombre visible, la URL del perfil, la biografía, la ubicación, el avatar, la portada, el estado de la cuenta, la fecha de creación y los contadores públicos.

Trátelos como valores públicos observados en collected_at. Guarde los registros repetidos del mismo id cuando necesite comparar el cambio a lo largo del tiempo.

El resultado depende de que el nombre de usuario sea válido y de acceso público cuando se ejecuta la recopilación. Las cuentas renombradas, privadas, suspendidas, restringidas o no disponibles pueden no producir un registro utilizable.

Cada resultado de perfil normalizado que se devuelve cuesta 0.6 créditos de SocQ.