Skip to main content
/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 encabezado ApiKey. Los nombres de encabezados HTTP no distinguen mayúsculas de minúsculas; el valor de la clave debe coincidir exactamente con el emitido.
Consulta Autenticación.

Cuerpo de la solicitud

Ejemplo de solicitud

Respuesta

Cada publicación incluye el perfil completo del autor. No hace falta una consulta adicional para añadir sus datos.
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 incluye next_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 es 429 Too Many Requests. Consulta Límites de solicitudes.

Códigos de error

Consulta la lista completa en Códigos de error.

Endpoints relacionados