X (Twitter) API Anahtarını 2026’da Nasıl Alırsınız

X API fiyatlandırması 2023’ten itibaren köklü değişiklikler gösterdi — ücretsiz erişim fiilen yok. Bu kapsamlı kılavuz, güvenli bir şekilde ölçeklenebilir X entegrasyonları oluşturmak için kimlik doğrulama, hız sınırları, optimizasyon stratejileri ve gerçek dünya kullanım örneklerini kapsar.
ChatGPT’in ne düşündüğünü gör
Tarafından
How to Get X (Twitter) API Key in 2026

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.

Kapsanan Temel Kavramlar:



  • 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:

KatmanAylık MaliyetYıllık TasarrufEn Uygun Olduğu AlanlarAna Özellikler
Ücretsiz$0Yalnızca geliştirme ve test içinAyda 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 sistemlerAylı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ırmaGeniş ö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
Gerçek dünya etkisi: Ücretsiz katman gerçekten yalnızca kavram kanıtı çalışmaları ve yerel geliştirme testleri için geçerlidir. Herhangi bir üretim uygulaması için en az Basic katmanı için bütçe ayırmalısınız ($200/ay).

🔮 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
Önemli Not: Kullanım başına ödeme modeli Aralık 2025 itibarıyla kapalı beta; mevcut katman fiyatlandırmasına göre uygulamanızı planlayın, ancak daha geniş dağıtımlar için duyuruları resmi X Geliştirici Twitter hesabı (@XDevelopers) üzerinden takip edin.

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.

X Authentication Methods

🔐 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

  1. Kullanıcı, uygulamanızda “X ile giriş yap” düğmesini tıklar
  2. Uygulamanız onları X’in yetkilendirme sayfasına yönlendirir
  3. Kullanıcı izin verir (talep edilen kapsamları siz belirlersiniz)
  4. X, bir yetkilendirme kodu döndürür
  5. Uygulamanız kodu bir erişim belirteciyle değiş tokuş eder
  6. 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
Neden daha az tercih edilir: Uygulama entegrasyonu daha karmaşık, OAuth 2.0’dan daha az güvenli ve X geliştiricileri yavaş yavaş OAuth 2.0’a doğru yönlendiriyor.

👥 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.

Güvenlik En İyi Uygulama: Tüm kimlik bilgilerini (API Anahtarları, Sırlar, Bearer Token’lar) ortam değişkenlerinde veya güvenli konfigürasyon dosyalarında saklayın – asla uygulama kodunuza gömülü olarak bırakmayın. Kimlik bilgileri açığa çıkarsa, geliştirici portalında derhal yeniden oluşturun.

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 KatmanTemel KatmanPro Paket
GET /2/users/:id (lookup user)1 istek / 24 saat100 istek / 24 saat900 istek / 15 dk
POST /2/tweets (gönderi oluştur)KullanılamıyorMevcutMevcut
GET /2/tweets/search/recentSınırlıMevcut450 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.

En İyi Uygulama: Uygulamanızda üssel geri çekme ve yeniden deneme mantığını uygulayın. 429 hatası aldığınızda, Retry-After’da belirtilen süre kadar bekleyip yeniden deneyin. Aylık kota tükenmesini önlemek için arama sonuçlarınızı agresif biçimde önbelleğe alın, aynı veriyi tekrar sorgulamaktan kaçının.

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.

Birleşik Etki: Beş optimizasyon stratejisini bir arada uygulamak, optimize edilmemiş koda kıyasla API tüketiminizi yüzde 70-90 azaltabilir. Günlük 5.000 ünite tüketen bir gösterge paneli, yalnızca optimizasyonla 500–1.500 üniteye düşebilir; kota artırımı talep etmeden.

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 KoduHTTP DurumuSebepÇözüm
Geçersiz İstek400Bozuk istek veya gerekli alanların eksik olmasıİstek formatını inceleyin, gerekli tüm parametrelerin mevcut olduğundan emin olun
Yetkisiz401Eksik veya geçersiz kimlik bilgileriBearer Token veya OAuth jetonlarının doğru ve süresinin dolmadığından emin olun
Yasak403Kimlik 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ı404Kaynak 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ı429Zaman penceresindeki çok fazla istekGeri çekme uygulayın, hız sınırı penceresi sıfırlandığında bekleyin (Retry-After başlığını kontrol edin)
Kota Aşıldı429Aylı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

  1. X Geliştirici Portalı’na gidin
  2. X hesabınıza giriş yapın (veya bir hesap oluşturun)
  3. Geliştirici profilini tamamlayın.
  4. 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.

  1. Geliştirici Portalında, “Proje Oluştur” üzerine tıklayın.
  2. Projene ad verin (ör. Analytics Dashboard)
  3. Kullanım senaryonuzu belirtin
  4. 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

  1. Projenizin içinde, “Uygulama Oluştur”
  2. Bir Uygulama adı seçin (örn. “Brand Monitor Bot”)
  3. Şartları kabul et
  4. 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.
Kritik Güvenlik Uyarısı: Bu kimlik bilgileri yalnızca bir kez görüntülenir. Hemen güvenli bir konuma kopyalayın (bir çevrimdışı parola yöneticisi, şifreli dosya veya ortam değişkenleri).

Ö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?

Ücretsiz katman mevcut ancak son derece sınırlıdır (aylık 500 paylaşım, çoğu uç noktada 24 saat başına 1 istek). Sadece geliştirme ve kavramsal çalışmalar için uygundur. Üretim uygulamaları için pratik minimum, Temel katmandır ($200/ay).

OAuth 2.0 ile Bearer Token’ları arasındaki fark nedir?

OAuth 2.0, belirli bir kullanıcı adına doğrulama yapar ve izin kapsamlarını verir. Bearer token (yalnızca uygulama) uygulamanız olarak doğrulama yapar ve kamuya açık verileri erişmenize olanak tanır. Kullanıcıların giriş yapması ve izin vermesi gerektiğinde OAuth 2.0’u kullanın; kamuya açık veriler için kullanıcı katılımı olmadan Bearer token’ları kullanın.

Erişim jetonları ne kadar sürer?

OAuth tokenları otomatik olarak geçerliliğini yitirmez—açıkça iptal edilene veya yeniden oluşturulana kadar geçerlidir. En iyi uygulama: güvenlik için her 90 günde bir tokenları yeniden oluşturun. Bir tokenin tehlikede olduğunu düşünüyorsanız, derhal yeniden oluşturun.

Rate limitinizi aştığınızda ne olur?

Retry-After başlığıyla HTTP 429 yanıtı alırsınız. Üssel geri çekme uygulayın ve belirtilen süre sonra yeniden deneyin. İsteğiniz reddedildiğinden başarısız denemeler için kota tüketilmez.

İstek sınırlarını veya aylık paylaşım kotamı artırabilir miyim?

Evet. Kota artırım talebini Google Cloud Console üzerinden gönderin. Kullanım amacınızı, kullanıcı sayınızı ve gerçekçi kullanım tahminlerinizi belirtin. Google, uygunluk ve meşruiyet temelinde inceler ve onaylar/reddeder. Kota artırımları ücretsizdir.

Projem için hangi katmanı seçmeliyim?

Ücretsiz katman: yalnızca geliştirme ve testler. Temel ($200/ay): çoğu gerçek dünya proje (içerik izleme, otomasyon, küçük uygulamalar). Pro ($5,000/ay): yüksek trafikli uygulamalar, çok sayıda kullanıcıya hizmet veren API’ler. Kurumsal ($42k+): SLA’lar ve özel destek gerektiren hayati öneme sahip sistemler.

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.

Makale tarafından
Teknik İçerik Uzmanı
Ivan, Elfsight’te teknik içerik uzmanıdır. Farklı platformlar için entegrasyonlar ve manuel iş yükünü azaltan otomasyon iş akışlarını kapsayan pratik API rehberleri ve geliştirici belgeleri yazar.