Twitter Tweet Scraper
Un post público de X combina su texto y su hora de publicación con un autor, archivos multimedia, hashtags, menciones, reacciones visibles y vínculos con la conversación que lo rodea. Capturar esa combinación a partir de una URL conocida hace más completos los catálogos de posts, los conjuntos de revisión y las comparaciones en momentos concretos.
Funcionalidades de la Twitter Tweet Scraper API
- Resolución exacta de URL de estadoResuelve uno o más enlaces públicos de x.com o twitter.com cuya ruta contenga un ID de estado numérico.
- Contexto del post y del autorDevuelve el ID y la URL canónicos del post, el texto completo, el idioma, la hora de publicación y la identidad pública del autor con el enlace a su perfil.
- Interacción, archivos multimedia y entidadesMantiene junto al post los Me gusta, las respuestas, los reposts, las citas, las vistas, los guardados, las referencias a archivos multimedia, los hashtags y las menciones.
- Contexto de la conversación y del origenConserva los identificadores de respuesta, conversación, cita, repost, origen y URL enviada para que un post conocido siga siendo rastreable.
Parámetros de la Twitter Tweet Scraper API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL de estado públicas de x.com o twitter.com. Cada URL debe contener un ID de post numérico en su ruta /status/. |
Cómo usar la Twitter Tweet Scraper API
Valide primero los enlaces de los posts y resuelva después los registros de estado exactos mediante una tarea de consulta asíncrona.
- Compruebe que cada URL pública de x.com o twitter.com contenga /status/{numeric_id}.
- Envíe por POST la lista urls validada a /v1/x/posts y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la consulta llegue a succeeded o failed.
- Obtenga data.results.items al terminar, siguiendo next_cursor hasta que has_more sea false.
curl -X POST "https://api.socq.ai/v1/x/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Twitter Tweet Scraper API
- Completar un catálogo de enlaces de posts: Reemplace enlaces de X sin contexto por texto en el que se pueda buscar, identidad del autor, referencias a archivos multimedia, entidades, hora de publicación e ID de post estables.
- Documentar posts de campañas: Capture el contenido exacto, el autor, los archivos multimedia, el contexto de relaciones y la interacción del momento de la recopilación para un conjunto aprobado de URL de campaña.
- Comparar instantáneas de posts seleccionados: Resuelva los mismos ID de post a intervalos definidos y compare Me gusta, respuestas, reposts, citas, vistas y guardados según collected_at.
Consejos de expertos para la Twitter Tweet Scraper API
- Rechace antes del envío los enlaces sin un ID numérico de /status/, para que las URL de perfiles y de búsquedas nunca entren en el lote de consulta.
- Extraiga el ID del post de las variantes de x.com y twitter.com y deduplique por ese ID y no por la cadena completa de la URL.
- Acompañe cada comparación de interacción con collected_at, porque los contadores públicos siguen cambiando después de la consulta.
- Trate las listas de archivos multimedia y los identificadores de respuesta, cita o repost como opcionales al almacenar registros de posts heterogéneos.
APIs relacionadas
Además de la Twitter Tweet Scraper API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter Profile Scraper API — Obtiene por nombre de usuario la identidad de la cuenta pública, biografías, avatares, imágenes de portada, estado de la cuenta y estadísticas visibles de audiencia.
- 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 Post Quotes API — Recolecta posts públicos con cita de URLs de estado conocidas, con comentario, autores, interacción, contenido multimedia, marcas de tiempo y contexto del post de origen.
- X Post Replies API — Recolecta respuestas públicas de URLs de posts de X con orden seleccionable, texto de la respuesta, autores, interacción visible, contenido multimedia y contexto del post principal.
- 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.
- Twitter Mentions API — Recolecta posts públicos que mencionan a una cuenta indicada.
- Twitter Search API
- X Followers List API
- X Following List API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location 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
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API