API Hop

Dokumentation

API Hop-Dokumentation

Twitter API

Mit einer einheitlichen Twitter-API Nutzerprofile und Chroniken in Antwortstrukturen nach X API v2 abfragen.

Dieser Dienst bietet eine einheitliche Twitter-REST-API. Aufrufer erhalten konsistente Antwortstrukturen im Stil von X API v2.

text
/v1/twitter

Authentifizierung

Alle Twitter-API-Endpunkte erfordern Bearer-Token-Authentifizierung.

http
Authorization: Bearer YOUR_API_KEY

Basispfad

Rufen Sie diese relativen Pfade unter Ihrer API-Basis-URL auf.

text
GET https://api.apihop.ai/v1/twitter/users
GET https://api.apihop.ai/v1/twitter/users/{id}
GET https://api.apihop.ai/v1/twitter/users/{id}/tweets

Antwortstruktur

Erfolgreiche Twitter-Antworten sind nicht in success/data eingeschlossen; sie liefern direkt die normalisierten Felder data, includes und meta.

Unterstützte Fähigkeiten

NutzerinformationenEinen Twitter-Nutzer über username oder eine Nutzerressource direkt über id abfragen.NutzerchronikDie Chronik eines Nutzers über id abrufen, einschließlich normalisierter Tweets, erweiterter Autoren und Paginierungsmetadaten.
  1. Haben Sie nur einen username, rufen Sie zuerst den Nutzer nach Nutzernamen ab und lesen Sie data.id.
  2. Rufen Sie mit data.id die Nutzerchronik ab.
  3. Benötigen Sie Autorenprofile in Chronikantworten, übergeben Sie expansions=author_id.

Normalisierungsregeln

  • Nutzerendpunkte liefern ein Nutzerobjekt: { "data": { ... } }
  • Chronikendpunkte liefern ein Tweet-Array: { "data": [ ... ], "meta": { ... } }
  • Bei angefordertem expansions=author_id enthalten Chronikantworten includes.users
  • user.fields und tweet.fields steuern die optionale Feldauswahl
  • Nutzerobjekte behalten stets id, name und username
  • Tweet-Objekte behalten stets id und text

Optionale Felder

user.fields

Unterstützte normalisierte Nutzerfelder:

  • created_at
  • description
  • entities
  • location
  • pinned_tweet_id
  • profile_banner_url
  • profile_image_url
  • protected
  • public_metrics
  • url
  • verified
  • verified_type

tweet.fields

Unterstützte normalisierte Tweet-Felder:

  • attachments
  • author_id
  • conversation_id
  • created_at
  • edit_history_tweet_ids
  • entities
  • in_reply_to_user_id
  • lang
  • possibly_sensitive
  • public_metrics
  • referenced_tweets
  • source

Fehleranalyse

  • Jede Antwort enthält X-Request-Id
  • Notieren Sie sie bei fehlgeschlagenen Aufrufen, auffälligen Ergebnissen oder Ratenlimits
  • Bewahren Sie bei Abrechnungsfragen X-Request-Id und Anfragezeit auf

Endpunkte

Nutzer nach Nutzernamen abrufenGET https://api.apihop.ai/v1/twitter/users?username=elonmuskNutzer nach ID abrufenGET https://api.apihop.ai/v1/twitter/users/44196397Nutzerchronik abrufenGET https://api.apihop.ai/v1/twitter/users/44196397/tweets