Saltar al contenido principal
La búsqueda de Posts es una función importante utilizada para mostrar conversaciones en X sobre un tema o evento específico. Si bien esta funcionalidad está presente en X, estos endpoints ofrecen mayor flexibilidad y potencia al filtrar e ingerir Posts, de modo que pueda encontrar datos relevantes para su 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 le permiten buscar Posts: búsqueda reciente y búsqueda en todo el archivo. Ambos endpoints REST comparten un diseño y características comunes, incluida su utilización de una única query de búsqueda para filtrar Posts en torno a un tema específico. Estas queries de búsqueda se crean con un conjunto de operadores que coinciden con atributos del Post y del usuario, como palabras clave del mensaje, hashtags y URL. Los operadores pueden combinarse en queries con lógica booleana y paréntesis para ayudar a refinar el comportamiento de coincidencia de las queries.  Tanto la búsqueda reciente como el endpoint de búsqueda en todo el archivo proporcionan metadatos de edición de Post. Todos los objetos de Posts creados desde el 29 de septiembre de 2022 incluyen metadatos de edición de Post, incluso si el Post nunca fue editado. 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 Post, consulte la página Edit Posts fundamentals. Una vez que haya configurado su query y comience a recibir Posts, estos endpoints permiten navegar 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órico: Las solicitudes abarcan un período de interés, sin enfocarse en la naturaleza en tiempo real de los datos. Se realiza una única solicitud y todos los datos coincidentes se entregan usando paginación según sea necesario. Este es el modo predeterminado para Search Posts.
  • Polling o escucha: Las solicitudes se realizan en modo “¿hay nuevos Posts desde mi última solicitud?”. Las solicitudes se realizan de forma continua y, por lo general, existe un caso de uso enfocado en la escucha casi en tiempo real de Posts de interés.
Muchos operadores y límites de query son exclusivos de Enterprise access, lo que significa que debe usar keys and tokens de una App dentro de un Project con acceso Enterprise para utilizar la funcionalidad adicional. Puede obtener más información sobre esto en las secciones de endpoints a continuación. Tanto la búsqueda reciente como los endpoints de búsqueda en todo el archivo cuyos Posts se devuelven contribuyen al Post cap mensual. Configuración de la cuenta Para acceder a estos endpoints, necesitará: Obtenga 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 estén usando keys and 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 private metrics, o un desglose de metrics orgánicas y promocionadas en tus resultados de Post, tendrás que usar Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE y pasar Access Tokens de usuario que estén asociados con el usuario que publicó el contenido en cuestión. Este endpoint puede entregar hasta 100 Posts por solicitud en orden cronológico inverso, y se proporcionan tokens de pagination para paginar conjuntos grandes de Posts coincidentes. Al usar un Project con acceso regular, puedes usar el conjunto básico de operators y realizar consultas de hasta 512 caracteres. Al usar un Project con acceso Enterprise, tienes acceso a operadores adicionales. Los Projects con acceso Enterprise pueden realizar consultas de hasta 4096 caracteres. Obtén más información sobre los niveles de acceso. El endpoint de búsqueda en el archivo completo de v2 solo está disponible para Projects con acceso Pro y Enterprise. Este endpoint le permite acceder de forma programática a Posts públicos del archivo completo, que se remonta al primer Post en marzo de 2006, según su query de búsqueda. Puede autenticar sus solicitudes a este endpoint usando OAuth 2.0 App-Only, y el App Access Token debe provenir de una App que esté dentro de un Project con acceso Pro o Enterprise. Dado que no puede hacer solicitudes en nombre de otros usuarios (Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE) con este endpoint, no podrá obtener metrics privadas. Este endpoint puede entregar hasta 500 Posts por solicitud en orden cronológico inverso, y se proporcionan tokens de paginación para recorrer conjuntos grandes de Posts coincidentes. Nota: Si solicita annotations mediante el parámetro tweet.fields, el parámetro max_results está actualmente limitado a un valor máximo de 100. Esto puede cambiar en el futuro, pero tenga en cuenta esta limitación. Dado que este endpoint solo está disponible para quienes hayan sido aprobados para acceso Pro y Enterprise, tendrá acceso al conjunto completo de operadores de búsqueda y podrá realizar consultas de hasta 1024 caracteres.







Recursos de apoyo Aprenda a usar Postman para realizar solicitudes Solucionar un error Visitar la página de referencia de la API
⌘I