Twitter API nedir?
Twitter API, bir web sitesi veya uygulamanın Twitter ile etkileşim kurmasını sağlayan bir arayüzdür. Bu sayede platformun ana özelliklerine, örneğin tweet paylaşmak, tweetleri yeniden paylaşmak ve belirli bir kelime içeren tweetleri web sitesi üzerinden bulmak gibi işlemler yapılabilir. Bu, söz konusu olan uç noktaları—sağlanan bilgilerin türüne karşılık gelen adresler—sayesinde mümkün olur. Tweetler, yanıtlar, doğrudan mesajlar, reklamlar ve yayıncı araçları Twitter API ile kolayca elde edilebilir.
Twitter API anahtarını nasıl elde edersiniz – Rehber
Twitter’ı sitenize bağlamak için elbette bir hesaba ihtiyacınız olacak. Henüz hesabınız yoksa Twitter API anahtarı oluşturun.
Adım 1: Twitter Geliştirici Hesabını açın
İlk olarak geliştiriciler bölümüne gidin.
Adım 2: Geliştirici hesabına başvur
Geliştiriciler için Twitter platformunda hesabınızla kaydolun.
İlk olarak, Twitter verilerini kullanacak olan gelecek uygulamanız hakkında bilgi sunmanız gerekecek.
Adım 3: Twitter API anahtarını kullanma nedenini seçin
Bu API, Twitter botu oluşturmak, öğretim amaçlı kullanmak, akademik araştırmalar yapmak ve bazı diğer amaçlar için de kullanılabilir.
Adım 4: Gerekli Alanları Doldurun
Yaşadığınız ülkeden birini seçin ve Twitter ekibinin sizi araması için istediğiniz adı yazın. İleri.
Adım 5: Gelecek uygulamanız hakkında ayrıntılı soruları yanıtlayın.
En az 100 karakter içeren birkaç soru var. Twitter’ı kullanacağınız proje hakkında belirli verileri doldurmanız gerekecek.
Ayrıca Twitter verilerini hiçbir şekilde analiz etmeyeceğiniz bir seçenek de tercih edebilirsiniz.
Adım 6: Bilgileri kontrol edin.
Her şey yolunda ise, “Looks good!” yazısına tıklayın.
Adım 7: Geliştirici Koşullarını Okuyun
Başvuruyu göndermek için inceleyip kabul edin. Twitter’a başvuru göndermeden önce doğrulanmış bir e-posta adresine sahip olmanız gerektiğini unutmayın.
Bekleme süresi neredeyse bir gün sürüyor; bazı geliştiriciler aylarca beklediklerini iddia ediyor. Her neyse, Twitter tabanlı bir uygulama geliştirmeye karar verdiyseniz, son dakikaya bırakmayın.
Her şeyi düzgün kontrol edin! Twitter her şeyi çok dikkatli inceler ve kullanım senaryonuz şüpheli görünürse başvuruyu reddederler. Bu karara itirazda bulunamayacaksınız.
Geliştirici erişimi için uygun olduğunuzda, ikinci aşamaya geçin – bir API anahtarı oluşturun.
Adım 8: Uygulamalar sekmesine tıklayın.
Sonraki adımda Kullanıcı API anahtarları bölümüne gidin. API anahtarınızı kopyalayın (kodunuzda ACCESS_TOKEN alanına yapıştıracaksınız) ve API sırrını (ACCESS_SECRET özelliği olarak kullanılacak).
“Access token” ve “Access token secret” kopyalayın. Aşağı kaydırarak Erişim belirteci ve Erişim belirteci sırrı bölümünü bulacaksınız. “Create”.
9. Adım: Tebrikler!
Son olarak, Twitter API anahtarınız ve Erişim belirteciniz elinizde. Şimdi web sitesinde sunmak istediğiniz Twitter içeriğini seçin; etkileşimli mi yoksa statik mi olsun.
Twitter API kimlik bilgileri
Özetle, üç ayaklı bir kimlik doğrulama ile kullanıcı erişim belirteçlerini elde etmeniz gerekecek: İstemci kimlik bilgileri, Geçici kimlik bilgileri, Jeton kimlik bilgileri.
Twitter API Örnekleri
API’lerin iki ana türü vardır: Streaming API ve REST API’ler. İlk olan, bir web sitesinde gerçek zamanlı tweet’ler yayınlamak için kullanılır; REST API’ler ise belirli içerik türlerini sunmak için kullanılır (yalnızca geçmiş tweet’ler, yorumlar veya sadece takipçiler). Öncelikle Streaming API’ye daha yakından bakalım.
Twitter Akış API’si
Streaming API, içeriğe müdahale etmenize izin vermez: sadece Twitter’dan gerekli tweetleri gerçek zamanlı olarak sunar. Uygulamadan bağlantıyı kestiğinizde, kaçınılmaz olarak API’sinden koparsınız. Twitter ile bağlantı kurduğunuzda, farklı türden verilerin bir akışını almaya başlayacaksınız: tweetler, bağlantının zaman aşımını önleyen keep-alive sinyalleri ve sistem mesajları. Twitter akış API’si, akış API’sinin tipik örneklerinden biridir.
Twitter Akış API
Bu API’yi uygulamanızda kullanarak, düzenli bir tweet akışından oluşan bir Twitter zaman çizelgesine erişeceksiniz. Ardından, bir durumlar filtresi veya yalnızca Enterprise kategorisi için kullanılan PowerTrack API ile bunları filtreleyebilirsiniz.
Twitter REST API’leri
REST, Representational State Transfer’ın kısaltmasıdır. Akış API’sinin aksine, istek-yanıt ilişkisi için hizmet verir: bir istemci benzersiz ve biçimlendirilmiş veri ister; sunucu yanıt verir ve bu veriyi sağlar. REST API durumsuzdur; oysa akış API’si durum bilgisi taşır. Ayrıca REST API’ler GET ve POST yöntemlerini kullanır. Yaptıkları işe bağlı olarak Twitter REST API’lerinin birçok örneği vardır; örneğin: User API, Twitter feeds API, Twitter followers API. Bunların birçoğunu daha sonra daha ayrıntılı olarak inceleyeceğiz.
Twitter Arama API’si
Tweet’leri arayabilir ve bunları web sitenizde gösterebilirsiniz; birçok farklı parametre kullanabilirsiniz. Bunlar geocode (konum), dil, sonuç tipi (sonuçlar: güncel veya en popüler), sayım (sayfa başına gösterilecek tweet sayısı) ve daha fazlasını içerir.
Kullanıcı API’si
Web geliştiricileri genellikle belirli bir kullanıcının takipçilerini ve arkadaşlarını elde etmek için Kullanıcı API’si kullanır. Ayrıca birinin en son tweetlerinin zaman akışını da görebilirsiniz.
Twitter API kaydı
Kullanıcılarınızın hesaplarının avantajlarından sitenizde faydalanmasını sağlayacak Giriş Yap veya Twitter ile Giriş Yap düğmesini kullanın. Önce bir istek belirteci edinmeniz gerekecek, ardından kullanıcıyı Twitter’a yönlendirin ve istek belirtecini erişim belirtecine dönüştürün.
Twitter Tweet API
Gönderiler için tweetleri ve beğenileri programlı olarak oluşturmanıza, geri yüklemenize ve silmenize olanak tanır. Post API aracılığıyla tweetlerin durumlarını görüntüleyip silebilirsiniz. Twitter Tweets API ayrıca Twitter API’den tweetler almanıza olanak tanır.
Trendler API
Web sitesi üzerindeki Twitter trendleri yaklaşık her beş dakikada bir güncellenir. Küresel trendler ile yerel trendleri de elde edebilirsiniz. İlgilendiğiniz ülkelerden gelen bilgileri sunmak için, Yahoo! GeoPlanet projesi tarafından verilen 32-bit bir tanımlayıcı olan place id’yi bulun.
Twitter Reklam API’si
Bu API, Twitter’da reklam kampanyalarını programatik olarak yönetmek için kullanılır. Twitter geliştiricileri, platformdaki reklam kampanyalarınızın verimliliğini Twitter Analytics API ile analiz etme imkanı sunar.
Twitter API durumları
Geliştiricilerin paylaşımların durumlarını almak için buna ihtiyaç duyabilirler (örneğin retweetler ve beğeniler).
Twitter Coğrafi Konum API’si
Belirli bir konum hakkında bilgi edinmenize olanak tanır ve aynı zamanda o konuma yakın yerleri de getirir. Geolocation API, durumlara veya eğilimlere bağlı konumları aramada yararlıdır. İstek, geçerli tüm konumların bir listesini döndürür.
Twitter API hız limitleri ve fiyatlandırma
Çoğu durumda, Twitter API’leri geliştiriciler tarafından ücretsiz olarak kullanılmaz. Projelerde Twitter verilerini kullanmaya ilişkin bazı kısıtlamalar vardır.
standart abonelik kullanıyorsanız aşağıdaki sınırlara maruz kalacaksınız:
| Uç Noktası | Kaynak ailesi | POST sınır penceresi | Kullanıcı Başına POST Limiti | Uygulama başına POST limiti |
| POST statuses/update | İçerik Oluştur | 3 saat | 300 | 300 |
| POST statuses/retweet/:id | İçerik Oluştur | 3 saat | 300 | 300 |
| POST favorites/create | Favoriler | 24 saat | 1000 | 1000 |
| POST friendships/create | Arkadaşlıklar | 24 saat | 400 | 1000 |
| POST direct_messages/events/new | Doğrudan mesajlar | 24 saat | 1000 | 15000 |
Daha fazla bilgi için, Twitter’ın hız sınırlarına ilişkin referans sayfasını inceleyin. GET uç noktaları hakkında orada da bazı bilgiler bulunmaktadır.
Temelde, projenizin büyüme aşamalarına karşılık gelen üç veri erişim seviyesi vardır: Standart, Premium ve Enterprise. Çoğu Twitter özelliği ücretsizdir, ancak daha iyi işlevsellik ve erişim için Premium veya Enterprise abonelik seviyesine geçmeniz gerekir.
Aşağıda, ana Twitter API’leri ve abonelik düzeylerine göre kullanılabilirliklerini gösteren bir tablo bulacaksınız.
| Standart (Ücretsiz) | Premium (aylık 149$ – 2.499$) | Kurumsal ($2499 ve üzeri) | |
| Yayınlama ve Etkileşim API’si | ✅ | ||
| Tweet Arama API’si: 7 gün | ✅ | ||
| Tweet Arama API’si: 30 gün | ✅ | ✅ | |
| Hesap ve Kullanıcı API’leri | ✅ | ✅ | ✅ |
| Reklam API’leri | ✅ | ||
| Web araçları | ✅ |
Twitter abonelik seviyeleri ve fiyatları hakkında daha fazla bilgi için onların sorgu sayfasına bakın.
Twitter API Değişiklikleri
Twitter API anahtarının iç işleyişini anlamak için değişiklik geçmişini bilmelisiniz.
2016 değişiklik: Search API, place, place_country ve profile_region gibi bazı coğrafi operatörlere destek ekledi.
2017 değişikliği: Tarihsel PowerTrack API ve Replay API güncellendi. Artık Alıntı Tweet filtrelemesini destekliyorlar. Ayrıca Anket Meta Verileri, Twitter Kurumsal API’leri üzerinden erişilebilir hale geldi.
2018 değişiklik: Kullanım API’sinin yeni bir sürümü kullanıma sunuldu. Sonuç olarak, geliştiriciler, Twitter hesaplarına giriş yaparken developer.twitter.com’daki Twitter uygulama panosu üzerinden mevcut Twitter uygulamalarını görüntüleyip düzenleyebildiler.
2019 change: PowerTrack’in geçmiş biçimi değişti; toplu geçmiş tweetler için artık üç değer mevcut: “name”, “description” ve “location”. Ayrıca Account Activity API’nin yeni bir özelliği duyuruldu. Bundan sonra geliştiricilerin, takip edilen kullanıcıyı bahseden bir hesabın engellenip engellenmediğini görmesi mümkün olacak.
2020 değişikliği: Erişim Jetonu ve Erişim Jetonu Sırrı’nı daha güvenli hale getirmek için, bunlar ilk kez üretildikten sonra kontrol panelinde görüntülenemiyor.
Twitter API Dokümantasyonu
Documentation. You’ll get acquainted with all the methods that should be used in all the types of APIs. Also, Twitter is eager to interact with developers. The platform launched a special workspace for programmers, where they get early access to new API features for testing. Twitter Developers’ Lab is great if you want to shape the future of the app.”>Başlamadan önce nihai dokümantasyonu inceleyin. Tüm API türlerinde hangi yöntemlerin kullanılacağını öğreneceksiniz. Ayrıca Twitter, geliştiricilerle etkileşime girmek konusunda hevesli. Platform, programcılar için yeni API özelliklerine erken erişim sağlayan özel bir çalışma alanı başlattı. Twitter Geliştiriciler Laboratuvarı, uygulamanın geleceğini şekillendirmek isterseniz harika.
SSS
Bir hata alırsam: “Twitter API kötü kimlik doğrulama verisi”?
Bu hatanın kodu 215’tir. HTTP 400 ile eşleşir. Bu yöntem için sunulan kimlik doğrulama sağlanmadı veya tamamen geçersizdi.
“Sunucu hatası – başvuru gönderilmedi” ne anlama geliyor?
Bu hata, Twitter hesabınızı doğrulamamanız halinde ortaya çıkabilir. Profilinizdeki Ayarlar sekmesine gidin, e-posta alanını bulun ve sonraki yönergeleri izleyin.
Twitter başvurum onaylanmazsa ne olacak?
Maalesef bu karara itiraz edemezsiniz. Bu nedenle, örneğin başka bir talep veya uygulama oluştamazsınız.
Tüm Twitter API hata kodlarını nerede bulabilirim?
Standart API ile çalışırken oluşan tüm hatları, Twitter Yanıt Kodları sayfasında bulabilirsiniz.
Twitter API oran limiti aşıldı. Bu ne anlama geliyor ve ne yapmalıyım?
Üçüncü taraf geliştiriciler uygulamalarında Twitter API’yi kullanabilir, ancak bu konuda bazı sınırlamalar vardır. Örneğin, saatte 100 çağrıyı geçemezsiniz. İstek hızı limiti aşıldığında bu mesajı alırsınız. Bir saatin sonuna kadar bekleyin veya bir sonraki abonelik planına (Premium veya Enterprise) yükseltin.
Sonuç
Twitter API anahtarı almak pek uzun sürmez ve karmaşık değildir. Yine de amatörler için biraz zorlayıcı olabilir: dokümantasyon, fiyatlandırma ve sınırlamalarla tanışmanız gerekir.
Elfsight’in Twitter Feed gibi hazır uygulamaları kullandığınızda, saniyeler içinde tweet paylaşmaya başlayabilirsiniz. Hiçbir Twitter API anahtarı veya kodlama becerisi gerekmez.
