API Genel Bakış

TwexAPI REST referansı — kimlik doğrulama, yanıt formatı, sayfalama, hatalar, hız sınırları ve uç nokta grupları.

TwexAPI, X/Twitter okuma, yazma, arama, takipçiler, DM’ler, listeler, topluluklar, makaleler ve hesap yardımcıları için https://api.twexapi.io adresinde bir REST API sunar.

Kenar çubuğundaki bireysel uç nokta sayfalarını açmadan önce bu sayfayı giriş noktası olarak kullanın.

Temel URL

https://api.twexapi.io

Yanıt formatı

Başarılı yanıtlar tutarlı bir zarf kullanır:

{
  "code": 200,
  "msg": "success",
  "data": {}
}

Hatalar JSON gövdesiyle birlikte 2xx dışı HTTP durum kodları döndürür. Durum kodu bazında kurtarma rehberi için Error Handling sayfasına bakın.

Birçok liste ve arama uç noktası data içinde has_next_page, next_cursor veya sayfa belirteçleri gibi imleç alanları döndürür. Sonraki istekte önceki yanıttaki imleci değiştirmeden iletin. İşler hata sonrası devam etmeliyse imleçleri sohbet veya iş akışı belleğinin dışında saklayın.

Bakiye kontrolü

Büyük dışa aktarmalardan önce kalan kredileri inceleyin:

curl --request GET \
  --url 'https://api.twexapi.io/balance' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Tam şema için Get Balance sayfasını açın.

Uç nokta grupları

Kenar çubuğundaki Endpoints altında oluşturulan sayfalara göz atın veya yaygın gruplara atlayın:

Grup	Tipik işler
Search	Anahtar kelime araması, hashtag’ler, cashtag’ler. `searchTerms` değerlerini Advance Search TwitterXAPI ile oluşturun.
Users	Profil sorgulama, toplu kullanıcı okuma
Followers & Following	Takipçi ve takip edilen dışa aktarımları
Tweet Actions	Gönderi, yanıt, beğeni, retweet, yer imi
Trending	Küresel trend konuları ve tweet’ler
DM	DM durumu, gönderme ve geçmiş
Balance	Kredi bakiyesi

Agent ve SDK yolları

Entegrasyon	Ne zaman kullanılır
MCP Server	`twexapi_request` çağırmadan önce `explore` ile rotaları keşfetmesi gereken AI agent’ları
SDKs	Yeniden deneme ve sayfalama yardımcıları olan tipli istemciler
CLI	Terminal betikleri ve JSON çıktısı
Framework Guides	LangChain, CrewAI, n8n, Prefect ve diğer agent barındırıcıları

Operasyonel kılavuzlar

Error Handling — HTTP durum kurtarma, MCP hataları ve yazma yeniden denemeleri
Rate Limits — verim rehberi ve 429 geri çekilme
— cookie / auth_token, yinelenen kontroller ve 403 kredileri
Authentication — API anahtarları, Bearer başlıkları ve yazma kimlik bilgileri

TwexAPI’nin bugün sunmadıkları

TwexAPI, birinci sınıf API ürünleri olarak yerel hesap monitörleri, olay webhook’ları veya asenkron çıkarma işleri sunmaz. Tekrarlayan işler için zamanlanmış REST çağrıları (Prefect, n8n, cron) veya agent devri için no-code platform webhook’ları kullanın, ardından doğrudan API istekleriyle devam edin.