Twitter API

API do Twitter: consulta de usuários, linhas do tempo e paginação

Integre endpoints Twitter / X do API Hop com autenticação Bearer, seleção de campos de usuários e tweets, paginação por cursor e tratamento de erros de validação.

Resolva o nome de usuário para um ID, obtenha a linha do tempo e passe o próximo token para outra página. Chamadas bem-sucedidas retornam JSON diretamente; não há consulta de Jobs nesses endpoints.

Obter uma chave de API Explorar o catálogo de APIs

Para uma tarefa específica

Implemente as três operações GET compatíveis e trate seus resultados.

Encontre uma conta pelo nome e selecione os campos de perfil a retornar.

Atualize uma conta conhecida pelo ID sem outra busca pelo nome.

Obtenha páginas da linha do tempo com limite de tamanho e token de paginação.

Unidade de cobrança

Como o uso é medido

USD por solicitação.

Limites operacionais

Os campos retornados dependem dos parâmetros documentados e da resposta do provedor.
max_results deve ser um inteiro de 1 a 100. Uma página pode conter menos resultados.
Guarde IDs de usuários e tweets como strings para evitar perda de precisão numérica.

Guias de integração

Escolha o próximo passo

Planeje atualizações e armazenamento Limite solicitações, remova posts duplicados e registre os horários de obtenção no aplicativo. Catálogo de APIs de dados Confira os produtos de dados, operações e preços por solicitação atuais.

Cobertura atual do catálogo

APIs disponíveis e unidades de cobrança

Compare IDs de API, operações, provedores e preços. Verifique a data do catálogo e a unidade de cobrança de cada operação antes de estimar os custos.

API de dados

Twitter User Data

twitter-user-data Documentação

Disponível

Obtenha perfis públicos de usuários do Twitter / X e suas linhas do tempo.

Provedor: Twitter / X Data
Unidade de cobrança: solicitação
Formatos de API e endpoints: Consulte as operações abaixo para os endpoints.
Recursos publicados: Busca de usuário, Linha do tempo do usuário

Operações publicadas

GET /v1/twitter/users Obter usuário pelo nome de usuário
GET /v1/twitter/users/{id} Obter usuário por ID
GET /v1/twitter/users/{id}/tweets Obter tweets do usuário

Preço do API Hop

Solicitação: $0.0020 /solicitação

Obter usuário pelo nome de usuário

GET /v1/twitter/users

Preço do API Hop

Solicitação: $0.0020 /solicitação

Obter usuário por ID

GET /v1/twitter/users/{id}

Preço do API Hop

Solicitação: $0.0020 /solicitação

Obter tweets do usuário

GET /v1/twitter/users/{id}/tweets

Preço do API Hop

Solicitação: $0.0020 /solicitação

Abrir o catálogo completo de APIs

Exemplo de solicitação

Comece pela operação documentada

curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

Use a URL base API da documentação da conta e substitua os marcadores. Envie a chave no cabeçalho Authorization, nunca em uma URL ou arquivo do repositório.

Endpoints

Três operações para contas e linhas do tempo

Buscar por nome de usuário GET /v1/twitter/users?username=<USERNAME>

Leia o data.id retornado como string para as solicitações seguintes.

Buscar por ID de usuário GET /v1/twitter/users/<USER_ID>

Obtenha uma conta conhecida e selecione opcionalmente os campos do perfil.

Linha do tempo do usuário GET /v1/twitter/users/<USER_ID>/tweets

Defina max_results e passe pagination_token para as próximas páginas.

Parâmetros de consulta

Selecione campos e pagine a linha do tempo

Consulta de conta: username é obrigatório em /v1/twitter/users. Ambos os endpoints aceitam uma lista user.fields separada por vírgulas, como description,public_metrics.
Tamanho da página: max_results aceita inteiros de 1 a 100. É um limite superior da página, não uma garantia da quantidade de posts.
Campos da linha do tempo: Use tweet.fields=created_at,public_metrics para datas e métricas. Solicite expansions=author_id com user.fields para detalhes disponíveis do autor. Use exclude=replies,retweets para excluir esses tipos de post.
Próxima página: Passe meta.next_token da resposta como pagination_token na próxima solicitação. Trate o token como opaco e codifique-o para URL. Pare se não houver próximo token, atingir o orçamento de páginas ou um token se repetir.

Tratamento de respostas

Leia os resultados JSON diretamente

As consultas retornam a conta em data. Linhas do tempo contêm um array data e meta.result_count, com meta.next_token se houver outro cursor. Expansões de autores podem aparecer em includes.users.

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

Exemplo de resposta vazia, não um resultado ao vivo. Campos opcionais e cursores podem estar ausentes. Uma página vazia não prova que a conta nunca publicou.

Erros de validação

Corrija parâmetros inválidos antes de tentar novamente

A falta de username ou um max_results fora do intervalo retorna HTTP 400 com success: false, error.code: 10001, error.message e requestId. Confira a mensagem e corrija a solicitação antes de repetir.

Rastreamento de solicitações

Guarde o ID da solicitação, não uma credencial

Guarde o cabeçalho X-Request-Id para suporte e rastreamento. Verifique o status HTTP antes de ler um resultado de sucesso e não inclua chaves API nem dados de perfil desnecessários nos logs.