Rotalar ve alan adına ait anahtar
API tabanı https://api.subredditdata.com adresidir. /v1/search geçmiş kayıtları arar; /v1/posts ve /v1/comments kayıt türünü sınırlar. Bu liste rotaları id gerektirmez. /v1/item tek kayıt için id ister. /v1/subreddits, topluluk adlarını prefix ve limit ile arar; üye sayısı ve büyüme geçmişi içeren tam bir topluluk profili sunmaz. /v1/status herkese açıktır ve kredi harcamaz.
Korunan okumalarda ham anahtarı X-API-Key başlığına yazın veya alternatif olarak aynı anahtarla Authorization: Bearer kullanın. X-API-Key değerinin başına Bearer eklemeyin. subredditdata.com anahtarını kullanmalısınız; başka ağ sitesinin anahtarı ve bakiyesi burada geçerli değildir. Hesap panelinin Secure HttpOnly oturum çerezi ayrı bir işleve sahiptir ve programın API anahtarının yerine geçmez. Gerçek anahtarı ortak çalışma tablosuna yazmayın.
İçerik sorgularında q, subreddit, author, kind, from, to, min_score, limit ve page desteklenir. kind, post veya comment olabilir; search için zorunlu değildir. q, title ve text içinde birden çok analiz edilmiş sözcüğü eşleşen alan düzeyinde AND ile arar. Her sözcüğün her iki alanda da bulunması gerekmez. Arama, tam ifade garantisi veya serbest bir sorgu dili olarak kullanılmamalıdır.
Parametreler rotaya bağlıdır: item yalnızca id, subreddits ise prefix ve limit kabul eder. Bilinmeyen parametre hata oluşturur. parent_id, link_id, duygu, demografi veya üye büyümesi filtresi yoktur. İki konuyu karşılaştırırken aynı rota ve kayıt türünü kullanın; uygulanmayan bir filtreyi tabloda açıkça boş bırakılmış olarak belirtin. Farklı sözcüklerin aynı kaydı bulabileceğini ayrıca izleyin.
Takvim günleri ve sınırlı kayıt kümesi
from ve to tam olarak YYYY-MM-DD biçimindedir ve created_utc için UTC sınırları tanımlar. from gece yarısından başlar; to günü 23:59:59 dahil kapsar. Örneğin from=2026-04-01 ve to=2026-04-30, Nisan ayının UTC takvim günleridir. to bugünse de günün tamamı kapsanır, yalnızca isteğin gönderildiği ana kadarki bölüm değil. Bu açıklama eksik veya gelecekteki kayıtların bulunacağı anlamına gelmez.
Yanıt düz kayıtlardan oluşur. İsteğe bağlı alanlar eksik veya boş olabilir; bir alandaki eksikliği uydurma değerle doldurmayın. parent_id ve link_id bulunduğunda yerel gruplama yapılabilir, fakat her üst kayıt veya tam konuşma elde edilmiş sayılmaz. Araştırma notunda hangi bağlamın okunamadığını belirtin. Yerel gruplama, sunucunun sağlamadığı bir bütünlüğü kendiliğinden yaratmaz.
limit ve page 1 ile 100 arasındadır. _doc sırası kronolojik, ilgililik veya puan sırası değildir. min_score yalnızca sayısal eşik uygular. Sayfa sınırına ulaşmak tam dışa aktarım kanıtı değildir. Toplamlarda eq kesin değeri, gte alt sınırı, unknown güvenilir toplam bulunmadığını belirtir; toplam null olabilir. Bunlar temsiliyet göstergesi değildir. Topluluk adı toplamları da küresel olarak kesin kabul edilmemelidir.
Hata ile kayıp yanıtı ayırın
HTTP 400 geçersiz istek, 401 eksik veya geçersiz anahtar, 402 yetersiz bakiye, 429 istek sıklığı sınırı demektir. Nedeni düzeltmeden aynı isteği sürekli yinelemeyin. Bir hata, konunun konuşulmadığına dair bulgu değildir. /v1/status yalnızca statik hizmet açıklaması ve HTTP yanıtı sağlar; arama kaynağını, arşiv sağlığını veya belirli kaydın erişilebilirliğini sınamaz.
Başarılı okuma, boş yanıt dahil bir kredi harcar. Geçersiz istek kredi düşmez; üst kaynak hatasında ayrılan kredi iade edilir. İstemcinin zaman aşımı veya kayıp yanıt ise sunucunun başarısız olduğunu kanıtlamaz. İşlem başarıyla tamamlanıp ücretlendirilmiş olabilir; başarılı tekrar ayrıca ücretlendirilir. Yanıt sonrasında yerel analizinizin hata vermesi de başarılı isteğin ücretini geri almaz.
