API Hop

Belgeler

API Hop Belgeleri

Twitter API

Birleşik Twitter API ile X API v2 yanıt yapılarında kullanıcı profillerini ve zaman akışlarını sorgulayın.

Bu hizmet birleşik bir Twitter REST API sunar. Çağrı yapanlar tutarlı, X API v2 tarzında yanıt yapıları alır.

text
/v1/twitter

Kimlik doğrulama

Tüm Twitter API uç noktaları Bearer belirteciyle kimlik doğrulama gerektirir.

http
Authorization: Bearer YOUR_API_KEY

Temel yol

Bu göreli yolları API temel URL’niz altında çağırın.

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

Yanıt yapısı

Başarılı Twitter yanıtları success/data içinde sarmalanmaz; normalleştirilmiş data, includes ve meta alanlarını doğrudan döndürür.

Desteklenen özellikler

Kullanıcı bilgileriusername ile Twitter kullanıcısını sorgulayın veya id ile kullanıcı kaynağını doğrudan alın.Kullanıcı zaman akışıid ile kullanıcı zaman akışını alın; normalleştirilmiş tweetler, genişletilmiş yazarlar ve sayfalama meta verileri dahildir.
  1. Yalnızca username varsa önce kullanıcı adıyla kullanıcıyı sorgulayın ve data.id değerini okuyun.
  2. data.id ile kullanıcı zaman akışını alın.
  3. Zaman akışı yanıtlarında yazar profilleri gerekiyorsa expansions=author_id gönderin.

Normalleştirme kuralları

  • Kullanıcı uç noktaları tek bir kullanıcı nesnesi döndürür: { "data": { ... } }
  • Zaman akışı uç noktaları bir tweet dizisi döndürür: { "data": [ ... ], "meta": { ... } }
  • expansions=author_id istendiğinde zaman akışı yanıtları includes.users içerir
  • user.fields ve tweet.fields isteğe bağlı alan seçimini kontrol eder
  • Kullanıcı nesneleri her zaman id, name ve username alanlarını korur
  • Tweet nesneleri her zaman id ve text alanlarını korur

İsteğe bağlı alanlar

user.fields

Desteklenen normalleştirilmiş kullanıcı alanları:

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

tweet.fields

Desteklenen normalleştirilmiş tweet alanları:

  • 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

Hata ayıklama

  • Her yanıt X-Request-Id içerir
  • Başarısız çağrı, olağandışı sonuç veya hız sınırı durumunda bunu kaydedin
  • Faturalandırma soruları için X-Request-Id ve istek zamanını saklayın

Uç noktalar

Kullanıcı adıyla kullanıcıyı sorgulamaGET https://api.apihop.ai/v1/twitter/users?username=elonmuskKimlikle kullanıcıyı sorgulamaGET https://api.apihop.ai/v1/twitter/users/44196397Kullanıcı zaman akışını sorgulamaGET https://api.apihop.ai/v1/twitter/users/44196397/tweets