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

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 previosAntes 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

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Búsqueda en todo el archivo con paginación
for page in client.posts.search_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    max_results=100
):
    for post in page.data:
        print(post.text)

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Búsqueda en todo el archivo con paginación
const paginator = client.posts.searchAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

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

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Búsqueda con campos y expansions
for page in client.posts.search_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "description"],
    max_results=100
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Búsqueda con campos y expansions
const paginator = client.posts.searchAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "description"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.created_at}: ${post.text?.slice(0, 50)}...`);
  });
}

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

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

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

Paso 1: Crear una consulta

Paso 2: Configurar un rango de tiempo

Paso 3: Realizar una solicitud

Paso 4: Revisa la respuesta

Paso 5: Añadir campos y expansions

Paso 6: Paginar los resultados

Guía de paginación

Principales diferencias con la búsqueda reciente

Parámetros comunes

Próximos pasos

Crear una consulta

Referencia de operadores

Guía de paginación

Referencia de la API