Twitter API

Twitter-API: Benutzersuche, Timelines und Paginierung

Integrieren Sie Twitter-/X-Endpunkte von API Hop mit Bearer-Authentifizierung, Auswahl von Nutzer- und Tweet-Feldern, Cursor-Paginierung und Validierungsfehlerbehandlung.

Lösen Sie einen Benutzernamen in eine Nutzer-ID auf, rufen Sie die Timeline ab und übergeben Sie das nächste Token für die Folgeseite. Erfolgreiche Aufrufe liefern direkt JSON; diese Endpunkte benötigen keine Jobs-Abfrage.

API-Schlüssel erhalten API-Katalog entdecken

Für eine bestimmte Aufgabe

Implementieren Sie die drei unterstützten GET-Vorgänge und verarbeiten Sie deren Ergebnisse.

Konto anhand des Benutzernamens auflösen und zurückzugebende Profilfelder auswählen.

Bekanntes Konto anhand der Nutzer-ID aktualisieren, ohne den Benutzernamen erneut abzufragen.

Timeline-Seiten mit Seitengrößenlimit und Paginierungstoken abrufen.

Abrechnungseinheit

So wird die Nutzung gemessen

USD pro Anfrage.

Betriebsgrenzen

Zurückgegebene Felder hängen von den dokumentierten Abfrageparametern und der Quellantwort ab.
max_results muss eine Ganzzahl von 1 bis 100 sein. Eine Seite kann weniger Ergebnisse enthalten.
Speichern Sie Nutzer- und Tweet-IDs als Zeichenfolgen, um Genauigkeitsverluste zu vermeiden.

Integrationsanleitungen

Wählen Sie den nächsten Schritt

Aktualisierung und Speicherung planen Begrenzen Sie Anfragen, entfernen Sie doppelte Beiträge und speichern Sie Abrufzeiten in Ihrer Anwendung. Daten-API-Katalog Prüfen Sie aktuelle Datenprodukte, Vorgänge und anfragebasierte Preise.

Aktuelle Katalogabdeckung

Verfügbare APIs und Abrechnungseinheiten

Vergleichen Sie API-IDs, Vorgänge, Anbieter und Preise. Prüfen Sie vor der Kostenschätzung Katalogdatum und Abrechnungseinheit jedes Vorgangs.

Daten-API

Twitter User Data

twitter-user-data Dokumentation

Verfügbar

Öffentliche Twitter-/X-Nutzerprofile und Nutzer-Timelines abrufen.

Anbieter: Twitter / X Data
Abrechnungseinheit: Anfrage
API-Formate und Endpunkte: Die Anfrage-Endpunkte stehen bei den Vorgängen unten.
Veröffentlichte Funktionen: Benutzersuche, Benutzer-Timeline

Veröffentlichte Vorgänge

GET /v1/twitter/users Nutzer nach Nutzernamen abrufen
GET /v1/twitter/users/{id} Nutzer nach ID abrufen
GET /v1/twitter/users/{id}/tweets Tweets eines Nutzers abrufen

API Hop-Preis

Anfrage: $0.0020 /Anfrage

Nutzer nach Nutzernamen abrufen

GET /v1/twitter/users

API Hop-Preis

Anfrage: $0.0020 /Anfrage

Nutzer nach ID abrufen

GET /v1/twitter/users/{id}

API Hop-Preis

Anfrage: $0.0020 /Anfrage

Tweets eines Nutzers abrufen

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

API Hop-Preis

Anfrage: $0.0020 /Anfrage

Vollständigen API-Katalog öffnen

Anfragebeispiel

Mit dem dokumentierten Vorgang beginnen

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

Verwenden Sie die API-Basis-URL aus Ihrer Kontodokumentation und ersetzen Sie die Platzhalter. Senden Sie den API-Schlüssel im Authorization-Header, niemals in einer URL oder eingecheckten Datei.

Endpunkte

Drei Vorgänge für Konten und Timelines

Nach Benutzername suchen GET /v1/twitter/users?username=<USERNAME>

Lesen Sie die zurückgegebene data.id für weitere Anfragen als Zeichenfolge.

Nach Nutzer-ID suchen GET /v1/twitter/users/<USER_ID>

Bekanntes Konto abrufen und optional Profilfelder auswählen.

Benutzer-Timeline GET /v1/twitter/users/<USER_ID>/tweets

Setzen Sie max_results und übergeben Sie pagination_token für Folgeseiten.

Abfrageparameter

Felder auswählen und Timeline paginieren

Kontensuche: username ist für /v1/twitter/users erforderlich. Beide Suchendpunkte akzeptieren eine kommagetrennte user.fields-Liste, etwa description,public_metrics.
Seitengröße: max_results akzeptiert Ganzzahlen von 1 bis 100. Es ist die Obergrenze der Seitengröße, keine Garantie für diese Beitragszahl.
Timeline-Felder: Nutzen Sie tweet.fields=created_at,public_metrics für Zeitstempel und Kennzahlen. Fordern Sie expansions=author_id mit user.fields für verfügbare Autorendetails an. Mit exclude=replies,retweets schließen Sie diese Beitragstypen aus.
Nächste Seite: Übergeben Sie meta.next_token aus der Antwort als pagination_token der nächsten Anfrage. Interpretieren Sie das Token nicht und URL-kodieren Sie es. Stoppen Sie ohne nächstes Token, bei erreichtem Seitenbudget oder wiederholtem Token.

Antwortverarbeitung

JSON-Ergebnisse direkt lesen

Benutzersuchen liefern das Konto in data. Timeline-Antworten enthalten ein data-Array und meta.result_count, außerdem meta.next_token, falls ein weiterer Cursor vorliegt. Autorenerweiterungen können in includes.users stehen.

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

Beispiel einer leeren Timeline, kein aktuelles Kontoergebnis. Optionale Felder und Cursor können fehlen. Eine leere Seite beweist nicht, dass das Konto nie gepostet hat.

Validierungsfehler

Ungültige Parameter vor erneutem Versuch korrigieren

Fehlendes username oder ungültiges max_results ergibt HTTP 400 mit success: false, error.code: 10001, error.message und requestId. Lesen Sie die Meldung und korrigieren Sie die Anfrage, statt sie unverändert zu wiederholen.

Anfragenachverfolgung

Anfrage-ID aufbewahren, keine Zugangsdaten

Bewahren Sie den Antwortheader X-Request-Id für Support und Nachverfolgung auf. Prüfen Sie den HTTP-Status vor dem Lesen erfolgreicher Nutzdaten und halten Sie API-Schlüssel sowie unnötige Profildaten aus Anwendungslogs fern.