x/
post-quotes

Recopile los posts de cita públicos de URL de estado de X conocidas, con el comentario, la identidad del autor, los archivos multimedia, las marcas de tiempo, el contexto de la conversación y las métricas visibles de interacción.

X Post Quotes API

Comentario de la cita
Contexto del post de origen
Límites por post
0.5 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

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

  1. Prepare URL públicas de x.com o twitter.com cuya ruta contenga /status/{numeric_id}.
  2. Envíe por POST la lista urls a /v1/x/post-quotes con un results_limit opcional y guarde el task_id.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
  4. 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 true

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

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.

Explorar otras plataformas

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

X Post Quotes API — FAQ

X Post Quotes API es una interfaz programática para recopilar los posts de cita públicos que hacen referencia a URL de estado de X conocidas. Devuelve comentarios normalizados, autores, interacción, archivos multimedia, marcas de tiempo y contexto del post de origen.

Envíe una lista urls que no esté vacía con enlaces públicos de x.com o twitter.com cuya ruta contenga /status/ seguido de un ID de post numérico.

La recopilación se centra en los posts de cita devueltos para cada estado de origen. Las respuestas y las cuentas que solo hicieron repost del origen se gestionan en recursos independientes.

Su valor predeterminado es 100 por cada URL de origen enviada y acepta múltiplos de 20 de 20 a 2,000. Los resultados públicos disponibles pueden ser menos que el tope solicitado.

Las páginas del proveedor se deduplican por ID de post para cada origen, y la persistencia almacena el mismo ID de post de cita normalizado una sola vez en toda la tarea.

La tarea estima 0.5 créditos por cada resultado solicitado entre las URL enviadas y luego se liquida a 0.5 créditos por resultado único guardado, con reembolso de los créditos cobrados por adelantado que no se usen.