Quickstart de Full-Archive Search

Esta guía te muestra cómo hacer tu primera solicitud de full-archive search para encontrar Posts del archivo completo de X, que se remonta hasta marzo de 2006.

Full-archive search 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 Developer Console en “Keys and tokens”)

Paso 1: Construye una consulta

Full-archive search admite todos los operadores de consulta. Construye consultas de la misma manera que recent search:

from:XDevelopers lang:en

Full-archive search admite consultas de hasta 1,024 caracteres (4,096 para Enterprise).

Paso 2: Establece un rango de tiempo

Por defecto, los resultados devuelven Posts de los últimos 30 días. Usa start_time y end_time para buscar períodos específicos:

Parameter	Format	Example
`start_time`	ISO 8601	`2020-01-01T00:00:00Z`
`end_time`	ISO 8601	`2020-12-31T23:59:59Z`

Paso 3: Realiza 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")

# Full-archive search 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" });

// Full-archive search 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

Ejemplo de 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
  }
}

Los Posts creados antes de que se introdujera la función de edición (septiembre de 2022) no incluirán edit_history_tweet_ids.

Paso 5: Añade fields y expansions

Solicita datos adicionales con 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 fields 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 fields 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: Pagina los resultados

Los SDKs manejan la paginación automáticamente. Para cURL, usa 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

Aprende más sobre cómo navegar por conjuntos de resultados grandes

Diferencias clave con recent search

Feature	Recent Search	Full-Archive Search
Rango de tiempo	Últimos 7 días	Marzo de 2006 hasta ahora
Acceso requerido	Todos los desarrolladores	Pay-per-use, Enterprise
Máximo de resultados por solicitud	100	500
Longitud de consulta	512 caracteres	1,024 caracteres
Límite de tasa	450 / 15 min	300 / 15 min, 1 / seg
Autenticación	App-Only, User Context	App-Only

Parámetros comunes

Parameter	Description	Default
`query`	Consulta de búsqueda (obligatorio)	—
`max_results`	Posts por página (10-500)	10
`start_time`	Timestamp más antiguo del Post	Hace 30 días
`end_time`	Timestamp más reciente del Post	Ahora
`next_token`	Token de paginación	—
`tweet.fields`	Fields adicionales de Post	`id`, `text`
`expansions`	Objetos relacionados a incluir	—

Próximos pasos

Construir una consulta

Domina la sintaxis y los operadores de consulta

Referencia de operadores

Consulta todos los operadores disponibles

Guía de paginación

Maneja conjuntos de resultados grandes

Referencia de la API

Documentación completa del endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Quickstart de Full-Archive Search

Paso 1: Construye una consulta

Paso 2: Establece un rango de tiempo

Paso 3: Realiza una solicitud

Paso 4: Revisa la respuesta

Paso 5: Añade fields y expansions

Paso 6: Pagina los resultados

Guía de paginación

Diferencias clave con recent search

Parámetros comunes

Próximos pasos

Construir una consulta

Referencia de operadores

Guía de paginación

Referencia de la API

​Paso 1: Construye una consulta

​Paso 2: Establece un rango de tiempo

​Paso 3: Realiza una solicitud

​Paso 4: Revisa la respuesta

​Paso 5: Añade fields y expansions

​Paso 6: Pagina los resultados

Guía de paginación

​Diferencias clave con recent search

​Parámetros comunes

​Próximos pasos

Construir una consulta

Referencia de operadores

Guía de paginación

Referencia de la API

Paso 1: Construye una consulta

Paso 2: Establece un rango de tiempo

Paso 3: Realiza una solicitud

Paso 4: Revisa la respuesta

Paso 5: Añade fields y expansions

Paso 6: Pagina los resultados

Diferencias clave con recent search

Parámetros comunes

Próximos pasos