/search-tweets consulta el índice público de búsqueda de X (Twitter) mediante palabras clave y operadores. Devuelve las publicaciones coincidentes con los perfiles completos de sus autores y sus métricas de interacción.
Consulta patrones de uso, plantillas de consultas y código funcional en la guía de búsqueda mediante API del blog.
Endpoint
Autenticación
Envía la clave en el encabezadoApiKey. Los nombres de encabezados HTTP no distinguen mayúsculas de minúsculas; el valor de la clave debe coincidir exactamente con el emitido.
Cuerpo de la solicitud
Ejemplo de solicitud
Respuesta
Consulta todos los campos en Formato de respuesta.
Operadores de consulta
query admite los operadores nativos de X, incluidos:
- Palabras clave y frases exactas:
"climate change". - Filtros de usuarios:
from:,to:,@mention. - Filtros de interacción:
min_faves:,min_retweets:,min_replies:. - Filtros de contenido:
filter:media,filter:images,filter:videos,filter:links; añade-delante para excluir. - Idioma y fechas:
lang:en,since:2026-01-01,until:2026-03-01. - Lógica booleana:
OR, paréntesis para agrupar y-para excluir.
Referencia completa: Operadores de búsqueda.
Paginación
La respuesta incluyenext_cursor. Para obtener la siguiente página, repite la misma solicitud con ese valor. Si el campo es null o no aparece, se han agotado los resultados.
Consulta los patrones y casos especiales en Paginación.
Límite de solicitudes
20 solicitudes por segundo y por clave de API en todos los planes. Si se supera, la respuesta es429 Too Many Requests. Consulta Límites de solicitudes.
Códigos de error
Consulta la lista completa en Códigos de error.
Endpoints relacionados
- Seguimiento de menciones: seguimiento específico de
@handlecon más filtros en el cuerpo de la solicitud. - Publicaciones de un usuario: cronología de una cuenta.
- Búsqueda de usuarios: encuentra cuentas por palabras clave.