X API (önce Twitter API) 2023’ten beri Elon Musk’ın satın alımından sonra belirgin değişiklikler yaşadı. Bir zamanlar ücretsiz, geliştirici dostu olan bir platform şimdi sıkı fiyatlandırma katmanları ve dikkatle yönetilen erişim seviyeleriyle premium bir hizmet. Botlar geliştirenler, gerçek zamanlı verileri entegre edenler veya sosyal medya yönetim araçları yaratanlar için mevcut X API ekosistemini anlamak hayati önem taşıyor.
Bu kapsamlı rehber, 2026 yılında X API kimlik bilgilerini edinme, gerçek maliyetleri anlama ve verimlilik için uygulanmasını optimize etme konularında bilmeniz gereken her şeyi adım adım anlatıyor.
- X API fiyatlandırmasının ücretsizten ödemeli modele geçişi ve ortaya çıkan kullanım başına ödeme modeline bakış
- Mevcut katmanlar ve kullanım durumunuza hangi katmanın uygun olduğunu gösterir
- Geliştirici Portalı’ndan API kimlik bilgilerinizi adım adım edin.
- Modern kimlik doğrulama yöntemleri ve izin kapsamları
- Maliyetleri düşürüp performansı artıracak beş strateji
Geliştirme iş akışınıza X API’nin nerede yer aldığını ve şu anda nelerin mevcut olduğunu anlamakla başlayalım.
X API Evrimi: Neler Değişti?
Twitter API yıllar içinde önemli ölçüde evrildi. İşte ana değişikliklerin zaman çizelgesi:
| Tarih | Etkinlik | Geliştiriciler Üzerindeki Etki |
|---|---|---|
| Ekim 2022 | Elon Musk Twitter’ı satın alıyor | API değişiklikleriyle ilgili spekülasyonlar başlıyor |
| Şubat 2023 | Ücretsiz API erişimi kaldırıldı | Üçüncü taraf istemciler (Tweetbot, Echofon) kapanır; fiyatlandırma zorunlu hale gelir. |
| Mart 2023 | Kullanıma sunulan ücretli katmanlar ($100, $2.500, $42.000) | Giriş ücreti 100 kat artar; geliştirici ekosistemi parçalanır |
| Haziran 2024 | Temel paket fiyatı aylık 200 USD’ye yükselir | Bağımsız geliştiriciler için daha yüksek giriş engeli |
| Ekim 2024 | Resmi yeniden markalaşma: Twitter → X | Tüm belgeler ve markalama güncellendi; eski sürüm kullanıcıları için kafa karıştırıcı |
| Kasım 2025 | Kullanıma göre fiyatlandırma beta sürümü başlıyor | Test için 500$ değerinde geliştirici kuponu içeren yeni tüketim odaklı model |
Ücretsiz erişim dört yıl içinde ayda 200–5.000 USD/ay aralığına çıktı. Uygulama planı yapmadan önce, API’nin gerçekten ne sunduğunu ve ihtiyaçlarınıza hangi katmanın uyduğunu anlayın.
X API ile Neler Geliştirebilirsiniz?
X API, X’in altyapısına programlı erişim sağlar — verileri almak, içerik yayımlamak ve yanıtları otomatikleştirmek için. En yaygın kullanım alanları şunlardır:
Marka Takibi ve Sosyal Zeka
Bahsileri, rakip aktivitelerini ve trend olan konuşmaları gerçek zamanında izleyin. Filtreli akışlar, belirli anahtar kelimeler veya hesaplar etkileşim ürettiğinde anında uyarılar sağlar; böylece ekipler markayla ilgili olaylara hızla yanıt verebilir.
İçerik Zamanlaması
Otomatik gönderi planları oluşturun, tek bir kontrol panelinden birden çok hesabı yönetin ve içerik iş akışlarını koordine edin. Ajanslar ve yaratıcılar bu araçları, manuel oturum açıp paylaşım döngülerine ihtiyaç duymadan onlarca X hesabını yönetmek için kullanır.
Web Sitesi İçeriği Entegrasyonu
Web sitelerine canlı X akışlarını, bireysel tweetleri ve trend konuları doğrudan ekleyin. Yayıncılar içeriği canlı X etkinlikleriyle senkronize tutar; manuel güncelleme veya eski gömme öğelerine ihtiyaç duymazlar.
Veri Analizi ve Araştırma
Büyük ölçekli çalışmalar, eğilim analizi ve piyasa araştırması için yapılandırılmış verilere erişin. API, geçmiş arama, etkileşim metrikleri ve kullanıcı verilerini manuel olarak toplanamayacak hacimlerde sağlar.
Yapay Zeka ve Duygu Analizi
Gerçek zamanlı X verisini makine öğrenimi modellerine, dil modellerine ve duygu analiz sistemlerine besleyin. Uygulamalar, izleyici takibi, söylem analizine ve öngörüsel analize kadar çeşitlenir.
X API Fiyatlandırması: 2026 Katman Sistemi
Bugünden itibaren X, devrim niteliğinde bir Kullanıma Dayalı Ödeme Modeli test ediyor; ancak geleneksel katman sistemi hâlâ geçerli standart olarak kalıyor. Her iki yaklaşım hakkında bilmeniz gerekenler şöyle.
💲 Mevcut Standart Fiyatlandırma
Üç ana katmandan oluşan çok katmanlı fiyatlandırma yapısı; her biri farklı kullanım ölçeklerine yöneliktir:
| Katman | Aylık Maliyet | Yıllık Tasarruf | En Uygun Olduğu Alanlar | Ana Özellikler |
|---|---|---|---|---|
| Ücretsiz | $0 | — | Yalnızca geliştirme ve test için | Ayda 500 gönderi, okumaya odaklı, çoğu uç noktada 24 saatte 1 istek, uç noktaya sınırlı erişim |
| Temel | $200 | $2,100/yıl (12,5% tasarruf) | Küçük projeler, içerik izleme, tek uygulama kullanımı | Aylık 15.000 okuma isteği, 50.000 yazma isteği, standart uç nokta erişimi |
| Profesyonel | $5,000 | $54,000/yıl (yüzde 10 tasarruf) | Büyüyen uygulamalar, tam özellik kümesi, kritik sistemler | Aylık 1.000.000 okuma isteği, aylık 300.000 yazma isteği, tam uç nokta erişimi, öncelikli destek |
| Kurumsal | $42,000+ | Özel Fiyatlandırma | Geniş ölçekli sistemler, özel altyapı | Özel hız sınırları, SLA’lar, ayrıcalıklı destek, gelişmiş özellikler, hacimsel indirimler |
Temel sürüm 25 kat daha ucuzdur (200$ karşı 5.000$). Pro sürümü size 100 kat daha fazla okuma kapasitesi sağlar ve tam arşiv araması ile gerçek zamanlı filtreleme gibi kritik özellikleri açar. Çoğu şirket, Ücretsiz → Temel → Pro üzerinden doğrudan ölçeklendirme yapar.
💢 Değişiklikler: Ücretsiz Erişimin Sonu
Ücretsiz erişimden ücretli erişime geçişin iki amacı vardı: platformun veri değerinden gelir elde etmek ve kötüye kullanımı azaltmak. Ücretsiz API erişimi, spam botları, veri kazıyıcılar ve kötüye kullanımın ölçekli biçimde gerçekleşmesine olanak tanırdı.
Ücretsiz Katman ile Sunulur
- Bir takvim ayında 500 paylaşım (günlük yaklaşık 16–17 paylaşım)
- Çoğu uç noktada 24 saat içinde 1 istekle sınırlı
- Gönderi paylaşma, beğenme veya etkileşime girme yok — yalnızca halka açık verilere salt okunur erişim
- Gönderi yazılamaz, kaynak oluşturulamaz veya hesap işlemleri gerçekleştirilemez
- Trendlere erişim yok, doğrudan mesajlaşma veya gelişmiş özellikler mevcut değil
🔮 Yeni Kullanım Başına Ödeme Modeli (Beta)
Kasım 2025’te X, devrim niteliğindeki bir fiyatlandırma yaklaşımı için kapalı bir beta başlattı: Kullandığın kadar öde. Sabit aylık ücretler yerine beta kullanıcıları, farklı API işlemleri için ayrı ayrı fiyatlar öder – AWS veya Google Cloud’un tüketim bazlı faturalandırmasına benzer.
Kullanım Başına Ödeme Nasıl Çalışır
Beta fiyatlandırma modeli, her işlem türüne özel maliyetler atar. Örneğin:
- Bir gönderiyi okumak için belirli bir ücret uygulanır (işleme göre değişir)
- Gönderileri arama daha maliyetli (daha yüksek hesaplama yükü)
- Gönderi oluşturmaya özgü bir ücret bulunur.
- Trendlere erişim için farklı bir fiyatlandırma katmanı gerekir
- Doğrudan mesajlaşma için ayrı fiyatlandırma bulunuyor
Kapatılmış beta süresindeki tüm geliştiriciler, üretimde kullanıma geçmeden önce denemeleri için 500$ değerinde bir kupon alırlar.
Potansiyel Avantajlar Sabit Katmanlara Göre
- Kullanılmayan kapasite için ödeme yok (sabit katman fiyatlandırmasıyla karşılaştırıldığında)
- Katman değiştirmeden ölçeklendirme yapabilme
- Özellik başına harcama üzerinde ayrıntılı kontrol
- Daha şeffaf maliyet ataması
X, beklenen kullanım desenlerinizi girip tam olarak ne kadar ödeyeceğinizi görebileceğiniz bir etkileşimli API maliyet hesaplayıcısı sağlar.
X Kimlik Doğrulama: Kimliğinizi Kanıtlayın
Her API isteği yapmadan önce kimlik doğrulaması yapmanız gerekir – X’e belirli verilere erişmeye yetkili olduğunuzu kanıtlayın. X API v2, çeşitli senaryolara uygun birden çok kimlik doğrulama yöntemi destekler.
🔐 OAuth 2.0 Yetkilendirme Kodu (Yeni Geliştirme İçin Önerilir)
OAuth 2.0 kimlik doğrulama için güncel standarttır ve tüm yeni geliştirmeler için önerilir. Eski yaklaşımlardan daha güvenlidir ve hem genel hem de özel kullanıcı verilerini işler.
OAuth 2.0 Ne Zaman Kullanılır
- Sıfırdan yeni uygulamalar geliştirmek
- Kullanıcı girişi gerektiren web uygulamaları ve mobil uygulamalar
- Özel kullanıcı verilerine erişim (özel listeler, taslak gönderiler)
- Kullanıcılar adına işlem yapmak (paylaşım yapmak, beğenmek, takip etmek)
Nasıl Çalışır
- Kullanıcı, uygulamanızda “X ile giriş yap” düğmesini tıklar
- Uygulamanız onları X’in yetkilendirme sayfasına yönlendirir
- Kullanıcı izin verir (talep edilen kapsamları siz belirlersiniz)
- X, bir yetkilendirme kodu döndürür
- Uygulamanız kodu bir erişim belirteciyle değiş tokuş eder
- Bu belirteci kullanıcı adına API isteklerinde kullanırsınız
Gerekli kimlik bilgileri: İstemci Kimliği, İstemci Sırrı ve Yönlendirme URI’si (geliştirici uygulama ayarlarında yapılandırılmış).
🔑 OAuth 1.0a Kullanıcı Bağlamı (Kullanım Eski, Hâlâ Destekleniyor)
Bu eski yöntem hâlâ destekleniyor ancak yeni geliştirme için önerilmez. OAuth 1.0a, belirli bir kullanıcı adına kimlik doğrulama yapar ve esas olarak mevcut uygulamalar için kullanışlıdır.
- Bir kullanıcının adına paylaşılan tweetler veya doğrudan mesajlar
- Belirli bir kullanıcının özel zaman akışını alın.
- Kullanıcıya özel kaynakları yönetme
👥 Taşıyıcı Jetonu (Uygulama için yalnız, Kamu Verileri için En İyisi)
Bearer token doğrulaması, kullanıcı bağlamı olmadan kamusal verilere erişmenin en basit yoludur. Yalnızca kamusal bilgilere ihtiyaç duyan araçlar geliştirirken bunu kullanın.
Ne Zaman Kullanılır
- Kamuya açık gönderileri arama
- Genel kullanıcı profillerini getir
- Kamuya açık trendleri görüntüleme
- Kamu içeriği için analiz araçları geliştirmek
Nasıl Çalışır: Uygulamanızın kimlik bilgilerini (API Anahtarı ve Gizli Anahtar) sağlayın, Erişim Belirteci alın, bu belirteci API istek başlıklarına ekleyin. Kullanıcı katılımı gerekli değildir.
X API v2: Uç Noktaları ve Kaynak Türleri
X API iki sürümde sunulur: v1.1 (miras, artık güncellenmiyor) ve v2 (mevcut standart). Tüm yeni projeler v2’yi kullanmalıdır; bu sürüm, Gönderiler, Kullanıcılar, Trendler, Etkileşim ve daha fazlası gibi kaynak türüne göre düzenlenmiş uç noktalara erişim sağlar. Her kaynak, katmanınıza ve izinlerinize bağlı olarak belirli işlemleri (okuma, oluşturma, güncelleme, silme) destekler.
Gönderiler (Tweetler) – Çekirdek Kaynak
Ne yapabilirsiniz: Gönderileri alın, kriterlere uygun gönderileri arayın, yeni gönderiler oluşturun, gönderileri silin, zaman çizelgelerine erişin
Yaygın uç noktalar:
- GET /2/tweets — Belirli gönderileri ID ile arayın
- GET /2/tweets/search/recent — Son paylaşımları ara (son 7 gün)
- POST /2/tweets — Yeni Bir Gönderi Oluştur
- GET /2/users/:id/tweets — Belirli bir kullanıcının paylaşımlarını alın
Gönderiler, X API’sinin temelidir. Neredeyse her kullanım senaryosu bir şekilde gönderileri almak, aramak veya oluşturmakla ilgilidir.
Kullanıcılar – Profil Bilgileri
Ne yapabilirsiniz: Kullanıcı profillerine erişin, takipçi bilgilerini alın, kullanıcıları arayın
Yaygın uç noktalar:
- GET /2/users/by/username/:username — Kullanıcı adından kullanıcıyı getir
- GET /2/users/:id — ID ile kullanıcıyı alın
- Kullanıcının takipçileri
Kullanıcı uç noktaları, profiller oluşturmanıza, takipçileri izlemenize ve hesap bilgilerini doğrulamanıza olanak tanır; X’i manuel ziyaret etmeye gerek kalmaz.
Etkileşim – Beğeniler, Retweetler, Yanıtlar
Ne yapabilirsiniz: Etkileşim metriklerini görüntüleyin, kimin beğendiğini veya paylaşımlarını retweet ettiğini takip edin, kullanıcı etkileşimini yönetin
Yaygın uç noktalar:
- GET /2/tweets/:id/liked_by — Bir gönderiyi beğenenleri gör
- POST /2/users/:id/likes — Bir gönderiyi beğen
- Alıntı Tweet’leri getir (yorum eklenmiş retweetler)
Etkileşim uç noktaları, içerik etkileşimlerini ve yanıtları izleyerek analitik panellerini ve topluluk yönetimi araçlarını güçlendirir.
Listeler – Kullanıcı Koleksiyonları
Ne yapabilirsiniz: Kullanıcıları içeren özenle derlenmiş listeler oluşturun ve yönetin; listedeki üyelerin gönderilerine erişin
Yaygın uç noktalar:
- GET /2/lists — Listelerinizi listeleyin
- POST /2/lists/:id/members — Listeye üye ekle
- GET /2/lists/:id/tweets — Listedeki üyelerin gönderilerini getir
Listeler, hesapları düzenlemek ve herkesi açıkça takip etmeden hedeflenen akışlar oluşturmak için kullanışlıdır.
Trendler – Şu Anda Neler Oluyor
Ne yapabilirsiniz: Gerçek zamanlı trend konular ve etiketler
Yaygın uç noktalar:
- GET /2/trends — Popüler konuları getir
- GET /2/users/personalized_trends — Bir kullanıcı için kişiselleştirilmiş trend konularını getir
Trend verileri keşif özelliklerini destekler ve uygulamaların X üzerinde şu anda gerçekleşen ilgili konuşmaları ortaya çıkarmasına yardımcı olur.
Filtreli Akış – Gerçek Zamanlı Veriler
Ne Yapabilirsiniz: Kurallarınıza uygun gerçek zamanlı gönderi akışına abone olun, gönderiler oluşturulduğunda bildirim alın
Yaygın uç noktalar:
- GET /2/tweets/search/stream — Filtreli akışa bağlanın
- POST /2/tweets/search/stream/rules — Akış kurallarını oluşturun veya değiştirin
Filtreli akış, gerçek zamanlı güncellemeler gereken uygulamalar için güçlüdür (marka bahsini izlemek, belirli anahtar kelimeleri takip etmek vb.) arama uç noktasını sürekli sorgulamadan.
Direct Messages – Özel İletişim
Ne yapabilirsiniz: Doğrudan mesajlar gönderin ve alın, konuşmaları yönetin
Yaygın uç noktalar:
- GET /2/dm_events — Doğrudan Mesajları Al
- POST /2/dm_conversations/:id/messages — Bir mesaj gönder
Doğrudan mesaj uç noktaları, X üzerinde kurulu müşteri destek otomasyonu ve bildirim sistemlerini mümkün kılar.
İstek Sınırları ve Kota Yönetimi
X API v2, iki tür sınırı zorunlu kılar: istek hızı sınırları (15 dakikalık pencereler başına) ve aylık gönderim sınırları (takvim ayı boyunca izlenir).
📨 İstek Hız Sınırları (15 Dakikalık Pencereler İçin)
Farklı uç noktalar, planınıza bağlı olarak farklı hız sınırlarına sahiptir.
| Uç Nokta Örneği | Ücretsiz Katman | Temel Katman | Pro Paket |
|---|---|---|---|
| GET /2/users/:id (lookup user) | 1 istek / 24 saat | 100 istek / 24 saat | 900 istek / 15 dk |
| POST /2/tweets (gönderi oluştur) | Kullanılamıyor | Mevcut | Mevcut |
| GET /2/tweets/search/recent | Sınırlı | Mevcut | 450 istek / 15 dk |
Ücretsiz katman, uç noktaya özel sınırları 24 saatlik pencerelerle ölçer (çok kısıtlayıcı). Temel ve Pro katmanları, pencerelerin sık sıfırlandığı 15 dakikalık pencereler kullanır; bu, çok daha cömerttir.
📊 Aylık Gönderi Tüketim Limitleri
İstek oranı sınırlarından bağımsız olarak, arama ve akış uç noktaları aylık bir “gönderi kotası”ndan kullanılır. Tüketildiğinde, bir sonraki takvim ayına kadar bu uç noktalara sorgu yapılamaz.
- Ücretsiz katman: 10.000 paylaşım
- Temel Paket: 500.000 paylaşımlar/ay
- Pro katmanı: 2.000.000+ gönderi/ay
Bu limitler özellikle şu konular için geçerlidir: son arama, filtreli akış, kullanıcı zaman çizelgeleri, ve bahsetme zaman çizelgeleri.
🚨 Sınırı Aştığınızda Ne Olur
Hız sınırını aştığınızda, X HTTP 429 (Too Many Requests) hatası yanıtı döndürür ve yeniden denemeden kaç saniye beklemeniz gerektiğini gösteren Retry-After başlığı ekler.
Aylık paylaşım kotanızı doldurduğunuzda, X bir 429 hatası döndürür ve kota sınırının aşıldığını belirtir. Bir sonraki takvim ayı başladığında bu uç noktadan sorgu yapmanız engellenir.
Beş Optimizasyon Stratejisi: Maliyetleri Düşürün ve Performansı Artırın
Kısıtlı hız sınırları ve aylık kotalar ile optimizasyon, uygulamanızın kapasitesini ve maliyetini doğrudan etkiler. API tüketimini azaltmaya yönelik kanıtlanmış stratejiler aşağıdadır.
1. Yanıt Boyutunu Azaltmak İçin Alan Seçimini Kullanın
Varsayılan olarak, API yanıtları ihtiyacınız olmayan birçok alan içerir. fields parametresiyle yalnızca belirli verileri talep edebilirsiniz.
Yerine:
GET /2/tweets?ids=TWEET_ID
Kullanım:
GET /2/tweets?ids=TWEET_ID&tweet.fields=created_at,public_metrics&expansions=author_id&user.fields=username
İkinci istek ihtiyacınız olan verileri döndürür; bu, daha küçük yanıtlar ve daha hızlı işleme sağlar.
2. Uygulama Düzeyi Önbellekleme
Uygun TTL değerleriyle API yanıtlarını veritabanınızda veya önbellek katmanınızda saklayın:
- Statik içerik (kullanıcı adları, görüntülenen adlar): 24 saat
- Yarı dinamik içerik (gönderi metni, etkileşim sayımları): 6 saat
- Gerçek zamanlı içerik (trend konuları): 30 dakika ile 1 saat
Gerçek etki: Önbellekleme sayesinde daha önce her 15 dakikada bir trend gönderilerini alan bir gösterge paneli, artık her 2 saatte bir çalışabilir; günlük API çağrılarını 96’dan 12’ye düşürerek %87,5 azalma sağlar.
3. Mümkün Olduğunda Toplu İstekler
Bazı uç noktalar tek bir istekle birden çok ID kabul eder.
3 ayrı istek yerine:
GET /2/tweets?ids=ID1 GET /2/tweets?ids=ID2 GET /2/tweets?ids=ID3
Bir toplu istek kullanın:
GET /2/tweets?ids=ID1,ID2,ID3
Bu, isteklerinizi 3’ten 1’e indirir ve kota limitinizin %67’sini tasarruf sağlar.
4. Geri Çekme ve Yeniden Deneme Mantığını Kullanın
Rate limitlerle karşılaşıldığında veya geçici hatalarda, üssel geri deneme ile yeniden deneyin:
- Yeniden denemeden önce 1 saniye bekleyin
- Yeniden denemeden önce 2 saniye bekleyin.
- 3. deneme için 4 saniye bekleyin
- Yeniden denemeden önce 8 saniye bekleyin.
Bu, API’ye aşırı yüklenmeyi önler ve geçici sorunların çözülmesi için zaman tanır.
5. Polling yerine Filtreli Akış’ı Düşünün
Kriterlerinizle eşleşen yeni gönderiler var mı diye sürekli arama yapmak yerine (polling), eşleşen gönderiler göründüğünde bildirimleri X’in ilettiği webhooks’a abone olun.
Tarama (Polling) Yaklaşımı: Her 5 dakikada bir kontrol edin = günde 288 kez. Çoğu kontrol “yeni veri yok” yanıtı verir (kota boşa harcanır).
Filtreli akış yaklaşımı: Veri değiştiğinde yalnızca bildirim alın. Boşa istek yok. Gerçek zamanlı güncellemeler.
Hata Yönetimi: Yaygın Sorunlar ve Çözümler
Yaygın hata kodlarını anlamak, hataları ayıklamanıza ve zarif bir şekilde toparlanmanıza yardımcı olur.
| Hata Kodu | HTTP Durumu | Sebep | Çözüm |
|---|---|---|---|
| Geçersiz İstek | 400 | Bozuk istek veya gerekli alanların eksik olması | İstek formatını inceleyin, gerekli tüm parametrelerin mevcut olduğundan emin olun |
| Yetkisiz | 401 | Eksik veya geçersiz kimlik bilgileri | Bearer Token veya OAuth jetonlarının doğru ve süresinin dolmadığından emin olun |
| Yasak | 403 | Kimlik doğrulama yapıldı ancak yetkili değilsiniz (izinler yetersiz) | OAuth akışınızda ek kapsamlar talep edin, kullanıcının yeniden onayını alın |
| Bulunamadı | 404 | Kaynak mevcut değil (geçersiz ID, silinmiş içerik) | Kaynak ID’sinin doğru olduğundan ve hâlâ mevcut olduğundan emin olun |
| Hız Sınırı | 429 | Zaman penceresindeki çok fazla istek | Geri çekme uygulayın, hız sınırı penceresi sıfırlandığında bekleyin (Retry-After başlığını kontrol edin) |
| Kota Aşıldı | 429 | Aylık gönderi kotası tükenmiş | Bir sonraki takvim ayına kadar bekleyin veya kota artışı talep edin |
🔧 Hata Yanıtlarını Ayrıştırma
Bir hata oluştuğunda, X ayrıntılarla JSON döndürür:
{ "errors": [ { "message": "The `ids` query parameter value is invalid", "type": "https://api.x.com/2/problems/invalid-request" } ] }
En iyi uygulama: API çağrılarını her zaman try-catch bloklarına alın ve hataları bir izleme sistemine kaydedin. Bu, desenleri belirlemenize ve sorunları daha hızlı gidermenize yardımcı olur.
X API Anahtarınızı Edinin: Adım Adım
Süreç, eski Twitter API’sine göre önemli ölçüde sadeleşti; yine de hâlâ kritik adımlar var:
🔗 Adım 1: Geliştirici Hesabı Oluşturun
- X Geliştirici Portalı’na gidin
- X hesabınıza giriş yapın (veya bir hesap oluşturun)
- Geliştirici profilini tamamlayın.
- Onay bekleniyor (genelde 5–10 dakika)
İlk kez gelen kullanıcılar, ilk Proje ve Uygulamanızı oluşturmaya rehberlik eden bir onboarding sihirbazı görecekler. Bunu görmüyorsanız, sol kenar çubuğundaki “Projeler ve Uygulamalar” bölümüne tıklayın.
📂 Adım 2: Bir Proje Oluştur
Bir Proje, bir veya daha fazla Uygulama için bir kapsayıcıdır. Bunu bir çalışma alanı olarak düşünün.
- Geliştirici Portalında, “Proje Oluştur” üzerine tıklayın.
- Projene ad verin (ör. Analytics Dashboard)
- Kullanım senaryonuzu belirtin
- Erişim katmanınızı seçin (test için Ücretsiz ile başlayın)
Varsayılan olarak Ücretsiz katmandasınız. Yükseltmek için: Geliştirici portalında “Ürünler” bölümüne gidin → X API v2 kartını bulun ve “View Access Levels”e tıklayın → İstediğiniz katmanı seçin.
🔨 Adım 3: Uygulama Oluştur
- Projenizin içinde, “Uygulama Oluştur”
- Bir Uygulama adı seçin (örn. “Brand Monitor Bot”)
- Şartları kabul et
- API anahtarlarınızı oluşturun
🔑 Adım 4: Kimlik Bilgilerinize Erişin
Uygulamanızın “Anahtarlar ve Jetonlar” sekmesine gidin. Şunları bulacaksınız:
- API Anahtarı (Tüketici Anahtarı): Uygulamanız için herkese açık bir tanımlayıcıdır. Kaynak kodunda güvenle paylaşılabilir.
- API Gizli Anahtarı (Consumer Secret): Bunu güvenli tutun! İstemci tarafı kodunda veya sürüm kontrolünde asla ifşa etmeyin.
- Bearer Token (yalnızca uygulama kimlik doğrulaması için): Uygulama için yalnızca kimlik doğrulama amacıyla kullanılır (salt okunur, kullanıcı bağlamı gerekli değildir). Ayrıca güvenli saklayın.
- İstemci Kimliği ve Sır (OAuth 2.0 için): OAuth 2.0 kimlik bilgileri. Uygulama ayarlarında OAuth 2.0’ı etkinleştirdiğinizde yalnızca görünür.
Önerilen Araçlar ve Kaynaklar
- Resmi X API Belgelendirmesi: Tüm uç noktalar, parametreler ve örnekler için yetkili kaynağıdır.
- Hız Sınırları Referansı: Uç nokta hız sınırlarının tüm katmanlara göre ayrıntılı dökümü.
- X Postman Collection: Postman’da test için önceden hazırlanmış API istekleri. Manuel uç nokta oluşturmayı ortadan kaldırır.
- X Geliştirici Topluluğu Forumu: Diğer geliştiricilerle bağlantı kurun, sorular sorun, sorunları bildirin.
- X Dev GitHub: Resmi örnek kodlar, SDK’lar ve Python, JavaScript, Java ve daha fazlası için kütüphaneler.
- İstemci Kitaplıkları: Resmi ve topluluk tarafından desteklenen SDK’lar birçok dilde. Ham HTTP isteklerine göre zaman kazandırır.
SSS: X API ile İlgili Sık Sorulan Sorular
X API’yi ücretsiz kullanabilir miyim?
OAuth 2.0 ile Bearer Token’ları arasındaki fark nedir?
Erişim jetonları ne kadar sürer?
Rate limitinizi aştığınızda ne olur?
İstek sınırlarını veya aylık paylaşım kotamı artırabilir miyim?
Projem için hangi katmanı seçmeliyim?
Daha fazla yardıma mı ihtiyacınız var? X X Geliştirici Dokümantasyonu veya ziyaret edin X Geliştirici Topluluk Forumu ile diğer geliştiricilerle bağlantı kurup topluluktan yanıtlar alın.
Sonraki Adımlar
X API ile çalışmak, fiyatlandırma, hız sınırları ve optimizasyon stratejilerini anladığınızda basittir. Marka konuşmalarını izlemek, içeriği otomatikleştirmek veya eğilimleri analiz etmek olsun, API ihtiyacınız olan her şeyi sunar. Küçük bir projeyle başlayın, bu beş optimizasyon stratejisini erkenden uygulayın ve oradan büyüyün.


