Twitter API

API Twitter : recherche d’utilisateurs, fils et pagination

Intégrez les endpoints Twitter / X de API Hop avec authentification Bearer, sélection des champs utilisateur et tweet, pagination par curseur et gestion des erreurs de validation.

Résolvez un nom en ID utilisateur, récupérez son fil et transmettez le token suivant pour une autre page. Les appels réussis renvoient directement du JSON ; ces endpoints n’utilisent pas de polling Jobs.

Obtenir une clé API Explorer le catalogue des API

Pour une tâche précise

Implémentez les trois opérations GET prises en charge et traitez leurs résultats.

Retrouvez un compte par nom et sélectionnez les champs de profil à renvoyer.

Actualisez un compte connu par ID sans nouvelle recherche du nom.

Récupérez les pages du fil avec une limite de taille et un token de pagination.

Unité de facturation

Comprendre la mesure de l’utilisation

USD par requête.

Limites opérationnelles

Les champs renvoyés dépendent des paramètres documentés et de la réponse en amont.
max_results doit être un entier de 1 à 100. Une page peut contenir moins de résultats.
Conservez les ID utilisateur et tweet sous forme de chaînes pour éviter une perte de précision numérique.

Guides d’intégration

Choisissez la prochaine étape

Planifiez les actualisations et le stockage Limitez les requêtes, dédupliquez les publications et enregistrez les heures de récupération dans votre application. Catalogue des API de données Examinez les produits de données, opérations et tarifs par requête actuels.

Couverture actuelle du catalogue

API disponibles et unités de facturation

Comparez les ID API, opérations, fournisseurs et tarifs. Vérifiez la date du catalogue et l’unité de facturation de chaque opération avant d’estimer les coûts.

API de données

Twitter User Data

twitter-user-data Documentation

Disponible

Récupérez les profils publics des utilisateurs Twitter / X et leurs fils de publications.

Fournisseur: Twitter / X Data
Unité de facturation: requête
Formats API et points de terminaison: Consultez les opérations ci-dessous pour les points de terminaison.
Fonctionnalités publiées: Recherche d’utilisateur, Fil de l’utilisateur

Opérations publiées

GET /v1/twitter/users Récupérer un utilisateur par son nom d’utilisateur
GET /v1/twitter/users/{id} Récupérer un utilisateur par son ID
GET /v1/twitter/users/{id}/tweets Récupérer les tweets d’un utilisateur

Tarif API Hop

Requête: $0.0020 /requête

Récupérer un utilisateur par son nom d’utilisateur

GET /v1/twitter/users

Tarif API Hop

Requête: $0.0020 /requête

Récupérer un utilisateur par son ID

GET /v1/twitter/users/{id}

Tarif API Hop

Requête: $0.0020 /requête

Récupérer les tweets d’un utilisateur

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

Tarif API Hop

Requête: $0.0020 /requête

Ouvrir le catalogue API complet

Exemple de requête

Commencez par l’opération documentée

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

Utilisez l’URL de base API de la documentation du compte et remplacez les espaces réservés. Envoyez la clé dans l’en-tête Authorization, jamais dans une URL ou un fichier versionné.

Points de terminaison

Trois opérations pour les comptes et les fils

Rechercher par nom d’utilisateur GET /v1/twitter/users?username=<USERNAME>

Lisez le data.id retourné comme une chaîne pour les requêtes suivantes.

Rechercher par ID utilisateur GET /v1/twitter/users/<USER_ID>

Récupérez un compte connu et choisissez ses champs de profil si nécessaire.

Fil de l’utilisateur GET /v1/twitter/users/<USER_ID>/tweets

Définissez max_results et transmettez pagination_token pour les pages suivantes.

Paramètres de requête

Sélectionnez les champs et paginez un fil

Recherche de compte: username est obligatoire sur /v1/twitter/users. Les deux endpoints acceptent une liste user.fields séparée par des virgules, comme description,public_metrics.
Taille de page: max_results accepte des entiers de 1 à 100. C’est une limite supérieure de taille de page, pas une garantie du nombre de publications.
Champs du fil: Utilisez tweet.fields=created_at,public_metrics pour les dates et mesures. Demandez expansions=author_id avec user.fields pour les détails disponibles sur l’auteur. Utilisez exclude=replies,retweets pour exclure ces types de publications.
Page suivante: Transmettez meta.next_token de la réponse comme pagination_token dans la requête suivante. Traitez-le comme opaque et encodez-le pour l’URL. Arrêtez-vous sans token suivant, au budget de pages atteint ou si un token se répète.

Traitement des réponses

Lisez directement les résultats JSON

Les recherches renvoient le compte dans data. Les fils contiennent un tableau data et meta.result_count, avec meta.next_token si un autre curseur existe. Les détails d’auteur peuvent figurer dans includes.users.

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

Exemple de fil vide, pas un résultat de compte en direct. Les champs facultatifs et curseurs peuvent manquer. Une page vide ne prouve pas que le compte n’a jamais publié.

Erreurs de validation

Corrigez les paramètres invalides avant de réessayer

L’absence de username ou un max_results hors limites renvoie HTTP 400 avec success: false, error.code: 10001, error.message et requestId. Examinez le message et corrigez la requête au lieu de la répéter telle quelle.

Traçage des requêtes

Conservez un ID de requête, pas un identifiant secret

Conservez l’en-tête X-Request-Id pour l’assistance et le traçage. Vérifiez le statut HTTP avant de lire un résultat réussi et excluez les clés API et données de profil inutiles des journaux.