Inicio rápido de búsqueda en el archivo completo

Busca en el archivo completo de Publicaciones desde 2006

Esta guía te guía paso a paso para realizar tu primera solicitud de búsqueda en el archivo histórico completo para encontrar Publicaciones en todo el archivo de X, desde marzo de 2006.

La búsqueda en el archivo completo requiere acceso Self-serve o Enterprise. Actualiza tu acceso para usar este endpoint.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador
• El Bearer Token de tu App (que se encuentra en la Consola de desarrollador, en “Keys and tokens”)

---

​

Paso 1: Crear una consulta

La búsqueda en el archivo completo admite todos los operadores de consulta. Crea consultas de la misma manera que en la búsqueda reciente:

from:XDevelopers lang:en

La búsqueda en todo el archivo admite consultas de hasta 1.024 caracteres (4.096 para Enterprise).

---

​

Paso 2: Configurar un rango de tiempo

De forma predeterminada, los resultados incluyen Publicaciones de los últimos 30 días. Usa start_time y end_time para buscar períodos específicos:

Parámetro	Formato	Ejemplo
start_time	ISO 8601	2020-01-01T00:00:00Z
end_time	ISO 8601	2020-12-31T23:59:59Z

---

​

Paso 3: Realizar una solicitud

cURL

shellscript

curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Paso 4: Revisa la respuesta

{
  "data": [
    {
      "id": "1271111223220809728",
      "text": "Tune in tonight and watch as @jessicagarson takes us through...",
      "edit_history_tweet_ids": ["1271111223220809728"]
    },
    {
      "id": "1270799243071062016",
      "text": "As we work towards building the new Twitter API...",
      "edit_history_tweet_ids": ["1270799243071062016"]
    }
  ],
  "meta": {
    "newest_id": "1271111223220809728",
    "oldest_id": "1270799243071062016",
    "result_count": 2
  }
}

Las Publicaciones creadas antes de que se introdujera la función de edición (septiembre de 2022) no incluirán edit_history_tweet_ids.

---

​

Paso 5: Añadir campos y expansions

Solicita datos adicionales mediante parámetros de consulta:

cURL

shellscript

curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,description&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Paso 6: Paginar los resultados

Los SDKs se encargan de la paginación automáticamente. Para cURL, utiliza el next_token de la respuesta:

curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
max_results=500&\
next_token=b26v89c19zqg8o3fo7gesq314yb9l2l4ptqy" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Guía de paginación

Más información sobre cómo navegar por conjuntos grandes de resultados

---

​

Principales diferencias con la búsqueda reciente

Función	Búsqueda reciente	Búsqueda en el archivo completo
Intervalo de tiempo	Últimos 7 días	Desde marzo de 2006 hasta la fecha
Acceso requerido	Todos los desarrolladores	Pago por uso, Enterprise
Máximo de resultados por solicitud	100	500
Longitud de la consulta	512 caracteres	1,024 caracteres
Límite de solicitudes	450 / 15 min	300 / 15 min, 1 / seg
Autenticación	App-Only, User Context	Solo App-Only

---

​

Parámetros comunes

Parámetro	Descripción	Predeterminado
query	Consulta de búsqueda (obligatoria)	—
max_results	Publicaciones por página (10-500)	10
start_time	Marca de tiempo de la Publicación más antigua	Hace 30 días
end_time	Marca de tiempo de la Publicación más reciente	Ahora
next_token	Token de paginación	—
tweet.fields	Campos adicionales de la Publicación	id, text
expansions	Objetos relacionados que se incluirán	—

---

​

Próximos pasos

Crear una consulta

Domina la sintaxis y los operadores de consulta

Referencia de operadores

Consulta todos los operadores disponibles

Guía de paginación

Gestiona conjuntos de resultados grandes

Referencia de la API

Documentación completa del endpoint