Arşiv Yapısı ve Filtreleme Temelleri
Bu bağımsız tarihsel Reddit arşivi canlı veya resmî bir Reddit hizmeti değildir. Geçmiş kayıtlara erişim, sabit ve değişmez bir anlık görüntü sunulduğu anlamına gelmez. Karşılaştırmanın yeniden incelenebilmesi için gerçekten alınan yanıtları, seçilen filtreleri ve yerel analiz kurallarını saklayın. Aynı sorgunun daha sonra aynı kayıtları getireceğini varsaymayın. Eksik kapsamı ve alınamayan sayfaları yöntem notlarına yazmak, çalışmanın hangi veriye dayandığını açıklar; tam temsiliyet sağlamaz.
Başlangıç örneği https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3 adresidir. Başka bir topluluk için ayrı bir istekte subreddit değerini değiştirin. q=soil ve karşılaştırma için seçtiğiniz diğer parametreleri sabit tutun. Üç kayıt yalnızca sorguyu incelemeye yarayan küçük bir üst sınırdır; araştırma sonucu veya temsili örneklem değildir. İki topluluğun verilerini ayrı kaydedip kaynak etiketini yerel analiz boyunca koruyun.
from ve to tarihlerini UTC takviminde YYYY-MM-DD biçiminde belirtin; to günü dahildir. Her iki topluluk için aynı aralığı kullanmak istek koşullarını eşler, ancak kapsam veya sıralama yanlılığını ortadan kaldırmaz. kind için post veya comment seçin; gönderi ve yorumları karşılaştırmada nasıl ayırdığınızı açıklayın. API sunucusunda duygu puanı veya istatistiksel karşılaştırma üretilmez; bu tür işlemler alınan örneklerde kendi yönteminizle yapılabilir.
Tartışma Karşılaştırmaları ve Analiz Yöntemleri
min_score yalnızca eşik filtresidir, puana göre sıralamaz. Aynı eşiğin farklı topluluklarda aynı önemi veya aynı katılım düzeyini temsil ettiğini varsaymayın. Eşik düşük puanlı konuşmaları dışarıda bırakabilir ve örneğin dilini değiştirebilir. Eğer sözcük sıklığı veya elle konu etiketleme yapacaksanız, kullandığınız normalleştirme ve dışlama kurallarını belgeleyin. Elde ettiğiniz farkları bütün topluluğun görüşü olarak sunmayın; arşivde alınan alt kümeyle sınırlandırın.
/v1/posts ve /v1/comments belirli türdeki kayıtları filtrelerle getirir. Tek bir bilinen kayıt için yol /v1/item, gerekli parametre id olarak yazılır. parent_id veya link_id yalnızca yanıtta varsa yerel ilişkilendirme için kullanılabilir; sorgu filtresi değildir. Eksik üst kayıtlar nedeniyle tam bir konuşma ağacı oluşmayabilir. Alıntıları mevcut bağlamla değerlendirin ve ilişkilendiremediğiniz kayıtları zorla bir konuşmaya eklemeyin.
author ve kind aramayı daraltabilir, fakat bir yazarın bütün katkılarını getirdiğini kanıtlamaz. Her istekte en fazla 100 kayıt, sorguda en fazla 100 sayfa alınabilir. Sayfalama ilişkisinde eq kesin toplam, gte alt sınır ve unknown bilinmeyen toplam demektir; toplam null olabilir. Sonuçları kaydettikten sonra ilerleme notunu güncelleyin. Uzak sayfaların değişmesi olasılığını hesaba katın; sayfa numarası eksiksiz veya yinelenmeyen toplama garantisi değildir.
Verimlilik, Limitler ve Teknik Detaylar
/v1/subreddits?prefix=... topluluk adlarını keşfetmek içindir. Sonuçların alfabetik veya sayımların küresel olarak kesin olduğunu varsaymayın; gerekirse alınan adları yerel olarak sıralayın. Ardından her topluluk için ayrı /v1/search isteği hazırlayın. /v1/status yalnızca statik açıklama ve HTTP yanıtı verir; aramanın sağlığını kontrol etmez. Başarılı veri çekme isteği boş dönebilir, dolayısıyla başarı kodu analiz için kayıt bulunduğunu göstermez.
Arşiv belge sırası kronolojik veya ilgililik sırası değildir. Sınırlı sayfa yinelemesinin tam kapsamı garanti etmemesi, belirli bir çalışmada mutlaka eksik kayıt olduğunu da kanıtlamaz; belirsizliği belirtir. Toplama koşullarını, kayıt sayılarını ve dışlanan metinleri raporlayın. Yerel yinelenen kayıt kuralınız varsa açıklayın. Filtreleri eşleştirmek yöntemsel tutarlılığı destekler, fakat veri kaynağının kapsamını veya iki topluluğun karşılaştırılabilirliğini kendiliğinden doğrulamaz.
Authorization: Bearer YOUR_API_KEY veya X-API-Key: YOUR_API_KEY başlıklarından biri geçerlidir. Gerçek anahtarı manifest veya paylaşılan araştırma dosyasına koymayın. HTTP 400 için parametreleri, 401 için anahtarı, 402 için bakiyeyi kontrol edin; 429 durumunda bekleyin. Geçersiz istekler kredi düşürmez, kaynak hataları rezervi iade eder. İstemci yanıtı kaybetse bile başarı ücretli olabilir; başarılı tekrarın maliyetini fiyatlandırma sayfasıyla bütçelendirin. Anahtar yenilemek veya fatura oluşturmak için anahtar sayfasındaki paneli kullanın.
