X Post Quotes
X Post Quotes recopila los posts de cita públicos que rodean a posts de X determinados y devuelve la identidad del autor, el comentario de la cita, los archivos multimedia, la hora de publicación y los datos visibles de interacción, para seguir opiniones, analizar el sentimiento y evaluar el rendimiento de la distribución.
Funcionalidades de la X Post Quotes API
- Expansión de posts de citaParta de una o más URL de estado públicas y recopile los posts públicos que citan esos orígenes, en lugar de las respuestas o de los perfiles que solo hicieron repost.
- Límites de origen independientesSolicite de 20 a 2,000 registros por post de origen en incrementos de 20, mientras cada estado enviado avanza con su propio cursor del proveedor.
- Registros de comentarios normalizadosReciba el texto de la cita, el idioma, la identidad del autor, las horas de publicación y de recopilación, los archivos multimedia, las entidades y la interacción visible en una estructura coherente.
- Rastreo del origen y deduplicaciónConserve en extra la URL enviada y el ID del post padre, mientras que los ID de posts de cita repetidos se almacenan una sola vez en toda la tarea.
Parámetros de la X Post Quotes API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL de estado públicas obligatorias de x.com o twitter.com. Las variantes de host admitidas deben contener un ID de post numérico después de /status/. |
results_limit | Opcional | Máximo opcional por cada post de origen enviado. El valor predeterminado es 100 y debe ser un múltiplo de 20 de 20 a 2,000. |
Cómo usar la X Post Quotes API
Envíe URL de estado públicas conocidas, consulte después la tarea asíncrona y recorra por páginas sus registros normalizados de posts de cita.
- Prepare URL públicas de x.com o twitter.com cuya ruta contenga /status/{numeric_id}.
- Envíe por POST la lista urls a /v1/x/post-quotes con un results_limit opcional y guarde el task_id.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
- Lea data.results.items y reutilice next_cursor mientras has_more sea true; este cursor de resultados es independiente de la paginación del proveedor.
X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"
curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"
# Poll GET /v1/tasks/{task_id}?limit=50
# Follow data.results.next_cursor while data.results.has_more is trueCasos de uso de la X Post Quotes API
- Estudiar el comentario añadido: Cree un conjunto de revisión con lo que agregaron los autores públicos al citar un lanzamiento de producto, un anuncio, un enlace de investigación o un post de campaña.
- Identificar amplificadores públicos: Compare los autores de las citas y la interacción visible para encontrar las cuentas cuyo enfoque generó una respuesta pública notable.
- Archivar instantáneas de posts de cita: Conserve los comentarios, las referencias a archivos multimedia, las marcas de tiempo y los contadores del momento de la recopilación para una lista definida de posts de origen.
Consejos de expertos para la X Post Quotes API
- Valide el nombre de host y el ID numérico de /status/ antes del envío; los enlaces de perfil, de búsqueda y los que no sean de estado se rechazan.
- Presupueste results_limit por post de origen y no por tarea: dos URL con 100 pueden estimar hasta 200 registros.
- Espere que un mismo ID de post de cita aparezca una sola vez en los resultados almacenados de la tarea, aunque varios orígenes enviados lleven a él.
- Trate el límite solicitado como un tope y no como una garantía de que esté completo, porque los posts eliminados, protegidos, restringidos o excluidos de la búsqueda pueden faltar.
- Almacene con cuidado los campos de archivos multimedia, entidades, conversación e interacción, que pueden ser nulos, y use collected_at al comparar contadores cambiantes.
APIs relacionadas
Además de la X Post Quotes API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter Tweet Scraper API — Obtiene el texto de posts públicos, autores, interacción, contenido multimedia, hashtags, menciones y relaciones de conversación desde URLs de estado de x.com o twitter.com.
- 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 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.
- X Community Posts API — Lee los posts públicos compartidos en una comunidad, con su texto, autores y conteos de interacción.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Trends API
- Twitter User Search API
- X Community 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