Quickstart de Full-Archive Search

Este guia mostra como fazer sua primeira requisição de full-archive search para encontrar Posts do arquivo completo da X, desde março de 2006.

O full-archive search requer acesso Self-serve ou Enterprise. Atualize seu acesso para usar este endpoint.

Pré-requisitosAntes de começar, você precisará de:

Uma conta de desenvolvedor
O Bearer Token do seu App (encontrado no Developer Console em “Keys and tokens”)

Passo 1: crie uma query

O full-archive search suporta todos os operadores de query. Crie queries da mesma forma que no recent search:

from:XDevelopers lang:en

O full-archive search suporta queries de até 1.024 caracteres (4.096 para Enterprise).

Passo 2: defina um intervalo de tempo

Por padrão, os resultados retornam Posts dos últimos 30 dias. Use start_time e end_time para pesquisar períodos específicos:

Parâmetro	Formato	Exemplo
`start_time`	ISO 8601	`2020-01-01T00:00:00Z`
`end_time`	ISO 8601	`2020-12-31T23:59:59Z`

Passo 3: faça uma requisição

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 com paginação
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 com paginação
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);
  });
}

Passo 4: revise a resposta

Exemplo de resposta

{
  "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
  }
}

Posts criados antes da introdução do recurso de edição (setembro de 2022) não incluirão edit_history_tweet_ids.

Passo 5: adicione fields e expansions

Solicite dados adicionais com query parameters:

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")

# Search com fields e 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" });

// Search com fields e 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)}...`);
  });
}

Passo 6: pagine pelos resultados

Os SDKs lidam com a paginação automaticamente. Para cURL, use o next_token da resposta:

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

Guia de paginação

Saiba mais sobre como navegar por grandes conjuntos de resultados

Principais diferenças em relação ao recent search

Recurso	Recent Search	Full-Archive Search
Intervalo de tempo	Últimos 7 dias	Março de 2006 até agora
Acesso necessário	Todos os desenvolvedores	Pay-per-use, Enterprise
Máx. de resultados por requisição	100	500
Tamanho da query	512 chars	1.024 chars
Rate limit	450 / 15 min	300 / 15 min, 1 / seg
Autenticação	App-Only, User Context	App-Only

Parâmetros comuns

Parâmetro	Descrição	Padrão
`query`	Query de busca (obrigatória)	—
`max_results`	Posts por página (10-500)	10
`start_time`	Timestamp do Post mais antigo	30 dias atrás
`end_time`	Timestamp do Post mais recente	Agora
`next_token`	Token de paginação	—
`tweet.fields`	Fields adicionais de Post	`id`, `text`
`expansions`	Objetos relacionados a incluir	—

Próximos passos

Criar uma query

Domine a sintaxe de query e os operadores

Referência de operadores

Veja todos os operadores disponíveis

Guia de paginação

Lide com grandes conjuntos de resultados

Referência da API

Documentação completa do endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Quickstart de Full-Archive Search

Passo 1: crie uma query

Passo 2: defina um intervalo de tempo

Passo 3: faça uma requisição

Passo 4: revise a resposta

Passo 5: adicione fields e expansions

Passo 6: pagine pelos resultados

Guia de paginação

Principais diferenças em relação ao recent search

Parâmetros comuns

Próximos passos

Criar uma query

Referência de operadores

Guia de paginação

Referência da API

​Passo 1: crie uma query

​Passo 2: defina um intervalo de tempo

​Passo 3: faça uma requisição

​Passo 4: revise a resposta

​Passo 5: adicione fields e expansions

​Passo 6: pagine pelos resultados

Guia de paginação

​Principais diferenças em relação ao recent search

​Parâmetros comuns

​Próximos passos

Criar uma query

Referência de operadores

Guia de paginação

Referência da API

Passo 1: crie uma query

Passo 2: defina um intervalo de tempo

Passo 3: faça uma requisição

Passo 4: revise a resposta

Passo 5: adicione fields e expansions

Passo 6: pagine pelos resultados

Principais diferenças em relação ao recent search

Parâmetros comuns

Próximos passos