Referencia de la API
URL base https://api.xsignalfeed.com. Todas las respuestas son JSON en el sobre descrito en Errores cuando fallan, y llevan las cabeceras enumeradas en Límites de tasa cuando tienen éxito. Los campos marcados con * son obligatorios.
Monitorización
Elige qué cuentas sigue esta clave. De cada una recibes todos los tipos de evento que tu clave permite, o solo los que elijas.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/monitor/targets | Listar cuentas monitorizadas | targets:read | 0 |
POST /v1/monitor/targets | Monitorizar una cuenta | targets:write | 0 |
GET /v1/monitor/targets/{target} | Obtener una cuenta monitorizada | targets:read | 0 |
PATCH /v1/monitor/targets/{target} | Elegir tipos de evento de una cuenta | targets:write | 0 |
DELETE /v1/monitor/targets/{target} | Dejar de monitorizar una cuenta | targets:write | 0 |
POST /v1/monitor/targets:batch | Operaciones de monitorización por lotes | targets:write | 0 |
Palabras clave
Vigila la búsqueda de X en busca de frases. La consulta acepta la sintaxis propia de X: frases exactas entre comillas, OR, -exclusions, #hashtags, $cashtags, from:, to:, lang:, filter:media, -filter:replies, -filter:retweets. Vigilamos la pestaña "Más recientes", así que los resultados son cronológicos, y funciona cualquier idioma o alfabeto.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/keywords | Listar palabras clave | keywords:read | 0 |
POST /v1/keywords | Vigilar una palabra clave | keywords:write | 0 |
DELETE /v1/keywords/{keyword_id} | Eliminar una palabra clave | keywords:write | 0 |
Flujo & historial
El WebSocket se describe en Transmisión; esto es su complemento REST para ponerse al día.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/events | Historial de eventos | replay | 0 |
Usuarios
Perfiles, listas de seguimiento, multimedia, menciones, suscripciones y búsqueda de usuarios, leídos de X ahora mismo. Cada llamada cuesta los créditos indicados.
Tweets
Publicaciones por id, con sus respuestas, citas, usuarios que republicaron, hilo y artículo. Cada llamada cuesta los créditos indicados.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/tweets/{tweet_id} | Obtener una publicación | reads | 1 |
GET /v1/tweets | Obtener publicaciones por ids | reads | 1 |
GET /v1/tweets/{tweet_id}/replies | Obtener respuestas | reads | 2 |
GET /v1/tweets/{tweet_id}/quotes | Obtener citas | reads | 2 |
GET /v1/tweets/{tweet_id}/retweeters | Obtener usuarios que republicaron | reads | 2 |
GET /v1/tweets/{tweet_id}/thread | Obtener un hilo | reads | 2 |
GET /v1/tweets/{tweet_id}/article | Obtener un artículo | reads | 1 |
Búsqueda
La búsqueda de X en su propia sintaxis, resultados más recientes o destacados, paginados.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/search | Buscar publicaciones | reads | 2 |
GET /v1/search/trends | Buscar una tendencia | reads | 2 |
Listas
Cronología y miembros de cualquier lista pública.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/lists/{list_id}/tweets | Obtener publicaciones de una lista | reads | 2 |
GET /v1/lists/{list_id}/members | Obtener miembros de una lista | reads | 2 |
Comunidades
Información, miembros, moderadores y publicaciones de una comunidad de X.
Tendencias
Lo que es tendencia en X ahora mismo, por categoría.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/trends | Obtener tendencias | reads | 2 |
Cuenta
Qué puede hacer esta clave, cuánto ha consumido, adónde van los webhooks.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/account | Obtener cuenta | — | 0 |
GET /v1/account/usage | Obtener consumo | — | 0 |
GET /v1/account/webhook | Obtener webhook | webhook | 0 |
PUT /v1/account/webhook | Configurar webhook | webhook | 0 |
Meta & estado
Público, en caché durante cinco minutos, sin clave. Construye tu validación y tu interfaz a partir de esto en lugar de copiar esta página.
| Endpoint | Nombre | Ámbito | Créditos |
|---|---|---|---|
GET /v1/meta/event-types | Listar tipos de evento | — | 0 |
GET /v1/meta/scopes | Listar ámbitos | — | 0 |
GET /v1/meta/plans | Listar planes | — | 0 |
GET /v1/meta/versions | Listar versiones | — | 0 |
GET /v1/health | Salud | — | 0 |
GET /v1/status | Estado | — | 0 |
Una descripción legible por máquina de todo lo anterior está en /v1/openapi.json; /v1/docs redirige aquí.