Twitter API

Twitter API: kullanıcı arama, zaman akışları ve sayfalama

API Hop Twitter / X uç noktalarını Bearer doğrulaması, kullanıcı ve tweet alanı seçimi, imleçli sayfalama ve doğrulama hatası işleme ile entegre edin.

Kullanıcı adını kimliğe çözümleyin, zaman akışını alın ve sonraki sayfa için dönen tokenı iletin. Başarılı çağrılar doğrudan JSON döndürür; bu uç noktalarda Jobs sorgulaması yoktur.

API anahtarı alın API kataloğunu keşfet

Belirli bir görev için

Desteklenen üç GET işlemini uygulayın ve sonuçlarını işleyin.

Kullanıcı adıyla hesabı çözümleyin ve döndürülecek profil alanlarını seçin.

Kullanıcı adını yeniden aramadan bilinen hesabı kullanıcı kimliğiyle yenileyin.

Sayfa boyutu sınırı ve sayfalama tokenıyla zaman akışı sayfalarını alın.

Faturalandırma birimi

Kullanımın nasıl ölçüldüğünü öğrenin

İstek başına USD.

İşletim sınırları

Dönen alanlar belgelenen sorgu parametrelerine ve üst sağlayıcı yanıtına bağlıdır.
max_results, 1 ile 100 arasında bir tam sayı olmalıdır. Bir sayfa daha az sonuç içerebilir.
Sayısal hassasiyet kaybını önlemek için kullanıcı ve tweet kimliklerini metin olarak saklayın.

Entegrasyon kılavuzları

Sonraki adımınızı seçin

Yenileme ve saklamayı planlayın İstek sayılarını sınırlayın, gönderileri tekilleştirin ve uygulamanızda alma zamanlarını kaydedin. Veri API kataloğu Güncel veri ürünlerini, işlemleri ve istek bazlı fiyatları inceleyin.

Güncel katalog kapsamı

Kullanılabilir API’ler ve faturalandırma birimleri

API kimliklerini, işlemleri, sağlayıcıları ve fiyatları karşılaştırın. Kullanım maliyetlerini tahmin etmeden önce katalog tarihini ve her işlemin faturalandırma birimini kontrol edin.

Veri API’si

Twitter User Data

twitter-user-data Dokümantasyon

Kullanılabilir

Herkese açık Twitter / X kullanıcı profillerini ve kullanıcı zaman akışlarını alın.

Sağlayıcı: Twitter / X Data
Faturalandırma birimi: istek
API biçimleri ve uç noktalar: İstek uç noktaları için aşağıdaki işlemlere bakın.
Yayımlanan yetenekler: Kullanıcı arama, Kullanıcı zaman akışı

Yayımlanan işlemler

GET /v1/twitter/users Kullanıcı adına göre kullanıcı alın
GET /v1/twitter/users/{id} Kullanıcı ID’sine göre kullanıcı alın
GET /v1/twitter/users/{id}/tweets Kullanıcının tweetlerini alın

API Hop fiyatı

İstek: $0.0020 /istek

Kullanıcı adına göre kullanıcı alın

GET /v1/twitter/users

API Hop fiyatı

İstek: $0.0020 /istek

Kullanıcı ID’sine göre kullanıcı alın

GET /v1/twitter/users/{id}

API Hop fiyatı

İstek: $0.0020 /istek

Kullanıcının tweetlerini alın

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

API Hop fiyatı

İstek: $0.0020 /istek

Tam API kataloğunu açın

İstek örneği

Belgelenen işlemle başlayın

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

Hesap belgelerinizdeki API temel URL’sini kullanıp yer tutucuları değiştirin. API anahtarını Authorization başlığında gönderin; URL’ye veya kaydedilen dosyaya eklemeyin.

Uç noktalar

Hesaplar ve zaman akışları için üç işlem

Kullanıcı adına göre bul GET /v1/twitter/users?username=<USERNAME>

Sonraki isteklerde kullanmak üzere dönen data.id değerini metin olarak okuyun.

Kullanıcı kimliğine göre bul GET /v1/twitter/users/<USER_ID>

Bilinen bir hesabı alın ve isteğe bağlı olarak profil alanlarını seçin.

Kullanıcı zaman akışı GET /v1/twitter/users/<USER_ID>/tweets

max_results ayarlayın ve sonraki sayfalar için pagination_token iletin.

Sorgu parametreleri

Alanları seçin ve zaman akışını sayfalayın

Hesap arama: /v1/twitter/users için username zorunludur. Her iki arama uç noktası da description,public_metrics gibi virgülle ayrılmış user.fields listesini kabul eder.
Sayfa boyutu: max_results 1 ile 100 arasında tam sayıları kabul eder. Sayfa boyutunun üst sınırıdır, o kadar gönderi garantisi değildir.
Zaman akışı alanları: Zaman damgaları ve ölçümler için tweet.fields=created_at,public_metrics kullanın. Yazar ayrıntıları için expansions=author_id ile user.fields isteyin. Bu gönderi türlerini hariç tutmak için exclude=replies,retweets kullanın.
Sonraki sayfa: Yanıttaki meta.next_token değerini sonraki istekte pagination_token olarak iletin. Tokenı yorumlamayın ve URL kodlayın. Sonraki token yoksa, sayfa bütçesine ulaşılırsa veya token tekrarlanırsa durun.

Yanıt işleme

JSON sonuçlarını doğrudan okuyun

Kullanıcı aramaları hesabı data içinde döndürür. Zaman akışı yanıtlarında data dizisi, meta.result_count ve başka imleç varsa meta.next_token bulunur. Yazar genişletmeleri includes.users içinde olabilir.

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

Örnek boş zaman akışı yanıtıdır, canlı hesap sonucu değildir. İsteğe bağlı alanlar ve imleçler olmayabilir. Boş sayfa, hesabın hiç gönderi paylaşmadığını kanıtlamaz.

Doğrulama hataları

Yeniden denemeden önce geçersiz parametreleri düzeltin

Eksik username veya aralık dışı max_results, success: false, error.code: 10001, error.message ve requestId içeren HTTP 400 döndürür. Mesajı inceleyip isteği düzeltin; değiştirmeden tekrarlamayın.

İstek izleme

Kimlik bilgisi değil, istek kimliği saklayın

Destek ve istek izleme için X-Request-Id yanıt başlığını saklayın. Başarılı içeriği okumadan önce HTTP durumunu kontrol edin; API anahtarlarını ve gereksiz profil verilerini uygulama günlüklerine koymayın.