---
title: "API Genel Bakış"
description: "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

```txt
https://api.twexapi.io
```

## Kimlik Doğrulama

Her istekte API anahtarınızı gönderin:

```bash
Authorization: Bearer YOUR_API_KEY
```

Public docs focus on API-key reads.

## Yanıt formatı

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

```json
{
  "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](/guides/error-handling) sayfasına bakın.

## Sayfalama

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:

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

Tam şema için [Get Balance](/api-reference/balance-endpoints/get-balance-api-balance-get) 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](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post) | Anahtar kelime araması, hashtag'ler, cashtag'ler. `searchTerms` değerlerini [Advance Search TwitterXAPI](https://x-advanced-search.cc) ile oluşturun. |
| [Users](/api-reference/twitter-user-about-endpoints/get-twitter-user-about-by-screen-name-api-twitter-screen-name-about-get) | Profil sorgulama, toplu kullanıcı okuma |
| [Followers & Following](/api-reference/followers-following-endpoints/followers-v3-api-v3-twitter-users-followers-post) | Takipçi ve takip edilen dışa aktarımları |
| [Tweet Actions](/api-reference/tweet-actions-endpoints/create-tweet-twitter-tweets-create-post) | Gönderi, yanıt, beğeni, retweet, yer imi |
| [Trending](/api-reference/trending-endpoints/get-global-trending-tweets-api-twitter-global-trending-tweets-get) | Küresel trend konuları ve tweet'ler |
| [DM](/api-reference/dm-endpoints/send-dm-v3-api-v3-twitter-send-dm-post) | DM durumu, gönderme ve geçmiş |
| [Balance](/api-reference/balance-endpoints/get-balance-api-balance-get) | Kredi bakiyesi |

## Agent ve SDK yolları

| Entegrasyon | Ne zaman kullanılır |
| --- | --- |
| [MCP Server](/mcp/overview) | `twexapi_request` çağırmadan önce `explore` ile rotaları keşfetmesi gereken AI agent'ları |
| [SDKs](/sdks) | Yeniden deneme ve sayfalama yardımcıları olan tipli istemciler |
| [CLI](/sdks/cli) | Terminal betikleri ve JSON çıktısı |
| [Framework Guides](/guides/langchain) | LangChain, CrewAI, n8n, Prefect ve diğer agent barındırıcıları |

## Operasyonel kılavuzlar

- [Error Handling](/guides/error-handling) — HTTP durum kurtarma, MCP hataları ve yazma yeniden denemeleri
- [Rate Limits](/guides/rate-limits) — verim rehberi ve `429` geri çekilme
- — cookie / `auth_token`, yinelenen kontroller ve `403` kredileri
- [Authentication](/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.