Saltar al contenido principal
Los endpoints de Search Posts te permiten encontrar Publicaciones que cumplan con criterios específicos mediante potentes operadores de consulta. Busca palabras clave, hashtags, menciones, URLs y más.

Descripción general

X ofrece dos endpoints de búsqueda con distintos rangos de tiempo y requisitos de acceso:

Búsqueda reciente

Busca Publicaciones de los últimos 7 días. Disponible para todos los desarrolladores.

Búsqueda de archivo completo

Busca en el archivo completo desde 2006. Disponible para clientes de pago por uso y clientes Enterprise.

Casos de uso

  • Monitoreo de marca — Haz un seguimiento de las menciones de tu marca o productos
  • Análisis de tendencias — Analiza las conversaciones sobre temas o eventos
  • Investigación — Recopila datos para investigaciones académicas o de mercado
  • Escucha en tiempo real — Crea aplicaciones que reaccionen ante nuevas Publicaciones

Endpoints

MethodEndpointDescriptionAccess
GET/2/tweets/search/recentBuscar publicaciones de los últimos 7 díasTodos los desarrolladores
GET/2/tweets/search/allBuscar en el archivo completo de publicacionesPago por uso, Enterprise

Operadores de consulta

Crea consultas utilizando operadores que coincidan con los atributos de las Publicaciones:
(AI OR "artificial intelligence") lang:en -is:retweet has:links
OperadorEjemploDescripción
KeywordpythonCoincide con Publicaciones que contienen la palabra
Phrase"machine learning"Coincide con la frase exacta
Hashtag#AICoincide con Publicaciones con el hashtag
Mention@XDevelopersCoincide con Publicaciones que mencionan a un usuario
OperadorEjemploDescripción
from:from:elonmuskPublicaciones de un usuario
to:to:XDevelopersRespuestas dirigidas a un usuario
retweets_of:retweets_of:XRetweets de las Publicaciones de un usuario
OperadorEjemploDescripción
has:imagescat has:imagesPublicaciones con imágenes
has:videoshas:videosPublicaciones con videos
has:linkshas:linksPublicaciones con enlaces
has:mentionshas:mentionsPublicaciones con menciones
url:url:github.comPublicaciones con una URL específica
OperadorEjemploDescripción
lang:lang:enPublicaciones en un idioma
-is:retweet-is:retweetExcluir retweets
-is:reply-is:replyExcluir respuestas
is:verifiedis:verifiedPublicaciones de usuarios verificados

Referencia completa de operadores

Ver todos los operadores disponibles y sus requisitos de acceso

Permite buscar Publicaciones de los últimos 7 días. Disponible para todos los desarrolladores.

Características

  • Hasta 100 Publicaciones por solicitud
  • Paginación para conjuntos de resultados grandes
  • Todos los operadores de consulta principales
  • Longitud máxima de la consulta de 512 caracteres (4.096 para Enterprise)

Inicio rápido

Realiza tu primera solicitud de búsqueda reciente

Referencia de la API

Documentación completa del endpoint

Busca en el archivo completo de Publicaciones desde marzo de 2006.
La búsqueda en el archivo completo está disponible para clientes de pago por uso y Enterprise.

Características

  • Hasta 500 Publicaciones por solicitud
  • Acceso al historial completo de Publicaciones
  • Todos los operadores de consulta disponibles
  • Longitud de consulta de 1.024 caracteres (4.096 para Enterprise)

Inicio rápido

Haz tu primera solicitud de búsqueda en el archivo completo

Referencia de la API

Documentación completa del endpoint

Primeros pasos

Requisitos previos

Crear una consulta

Aprende la sintaxis de las consultas y los operadores

Paginación

Navega entre conjuntos de resultados grandes

Guía de integración

Conceptos clave y mejores prácticas

Código de ejemplo

Ejemplos de código funcional