Saltar al contenido principalLa búsqueda de Posts es una función importante para descubrir conversaciones en X sobre un tema o evento específico. Aunque esta funcionalidad existe en X, estos endpoints brindan mayor flexibilidad y potencia al filtrar e incorporar Posts, para que puedas encontrar datos relevantes para tu investigación con mayor facilidad; crear aplicaciones de “escucha” casi en tiempo real; o, en general, explorar, analizar y/o actuar sobre Posts relacionados con un tema de interés.
Ofrecemos dos endpoints que te permiten buscar Posts: búsqueda reciente y búsqueda en el archivo completo. Ambos endpoints REST comparten un diseño y características comunes, incluido el uso de una única consulta de búsqueda para filtrar Posts en torno a un tema específico. Estas consultas se crean con un conjunto de operadores que hacen coincidencia con atributos del Post y del usuario, como palabras clave del mensaje, hashtags y URLs. Los operadores pueden combinarse en consultas con lógica booleana y paréntesis para afinar el comportamiento de coincidencia de las consultas.
Tanto los endpoints de búsqueda reciente como los de búsqueda en el archivo completo proporcionan metadatos de edición del Post. Todos los objetos correspondientes a Posts creados desde el 29 de septiembre de 2022 incluyen metadatos de edición del Post, incluso si el Post nunca se editó. Cada vez que se edita un Post, se crea un nuevo id de Post. El historial de ediciones de un Post se documenta mediante un arreglo de ids de Post, comenzando con el id original.
Estos endpoints siempre devolverán la edición más reciente, junto con cualquier historial de edición. Cualquier Post recopilado después de su ventana de edición de 30 minutos representará su versión final. Para obtener más información sobre los metadatos de edición de Posts, consulta la página Fundamentos de edición de Posts.
Una vez que hayas configurado tu consulta y comiences a recibir Posts, estos endpoints permiten navegar por los resultados tanto por tiempo como por rangos de id de Post. Esto está diseñado para admitir dos casos de uso comunes:
- Obtener históricos: las solicitudes abarcan un período de interés, sin centrarse en la naturaleza en tiempo real de los datos. Se realiza una única solicitud y todos los datos coincidentes se entregan utilizando paginación según sea necesario. Este es el modo predeterminado para Search Posts.
- Polling o listening: las solicitudes se realizan en modo “¿hay nuevos Posts desde mi última solicitud?”. Las solicitudes se efectúan de forma continua y, por lo general, el caso de uso se centra en la ‘escucha’ casi en tiempo real de Posts de interés.
Muchos operadores y límites de consulta son exclusivos del acceso Empresarial, lo que significa que debes usar claves y tokens de un App dentro de un Project con acceso Empresarial para utilizar la funcionalidad adicional. Puedes obtener más información sobre esto en las secciones de endpoints a continuación.
Tanto los endpoints de búsqueda reciente como los de búsqueda en el archivo completo cuyos Posts se devuelven contribuyen al límite mensual de Posts.
Configuración de la cuenta
Para acceder a estos endpoints, necesitarás:
Obtén más información sobre cómo acceder a los endpoints de X API v2 en nuestra guía de introducción.
El endpoint de búsqueda reciente te permite acceder de forma programática a Posts públicos filtrados publicados durante la última semana, y está disponible para todos los desarrolladores que tengan una cuenta de desarrollador y usen claves y tokens de una App dentro de un Project.
Puedes autenticar tus solicitudes con Contexto de usuario de OAuth 1.0a, OAuth 2.0 App-Only o Código de autorización de OAuth 2.0 con PKCE. Sin embargo, si deseas recibir métricas privadas o un desglose de métricas orgánicas y promocionadas en tus resultados de Post, deberás usar Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE y pasar Tokens de acceso de usuario asociados con el usuario que publicó el contenido en cuestión.
Este endpoint puede devolver hasta 100 Posts por solicitud en orden cronológico inverso, y se proporcionan tokens de paginación para recorrer grandes conjuntos de Posts coincidentes.
Al usar un Project con acceso regular, puedes usar el conjunto básico de operadores y realizar consultas de hasta 512 caracteres. Al usar un Project con acceso Empresarial, tienes acceso a operadores adicionales. Los Projects con acceso Empresarial pueden realizar consultas de hasta 4096 caracteres.
Obtén más información sobre los niveles de acceso.
Búsqueda en todo el archivo
