Subreddit Gönderileri

GET/v1/reddit/subreddit1 kredi

Bir subreddit'in gönderilerinden seçilen sıralamaya göre bir sayfa döndürür; her gönderi başlığı, yazarı, metni, puanı, yorum sayısı, flair'i ve bağlantılarıyla gelir.

01Sorgu parametreleri

Ad	Tür	Açıklama
subredditzorunlu	string	Subreddit'in adı, örneğin `golang`, ya da URL'si.
sortisteğe bağlı	string	Sıralama. Verilmezse Reddit'in varsayılanı kullanılır.Kabul edilen değerler:`besthotnewtoprising`
timeframeisteğe bağlı	string	Zaman aralığı; `sort=top` ile kullanılır.Kabul edilen değerler:`alldayweekmonthyear`
afteristeğe bağlı	string	Sonraki sayfayı almak için önceki yanıtın `after` değeri (`t3_1x0m2e6` gibi bir gönderi id'si).
trimisteğe bağlı	boolean	`true` verilirse her gönderiden bazı alanlar çıkarılır (`created_at_iso`, `permalink`, `post_hint`, `domain`, `subreddit_id`, `over_18`, `spoiler`).Varsayılan: `false`
cache_max_ageisteğe bağlı	string	Uyumluluk için kabul edilir; her çağrı güncel veriyle yanıtlanır ve normal ücretlendirilir. Listedeki değerler dışında bir değer ücretsiz bir 400 döndürür.Kabul edilen değerler:`1d3d7d14d30d`

02İstek

curl "https://api.scrapesocial.ai/v1/reddit/subreddit?subreddit=golang&sort=new" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/reddit/subreddit?subreddit=golang&sort=new

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "posts": [
    {
      "id": "1xf72kd",
      "author": "der_gopher",
      "author_fullname": "t2_149tyuiyao",
      "subreddit": "golang",
      "title": "Golang optimizations for high‑volume services",
      "link_flair_text": "show & tell",
      "selftext": null,
      "selftext_html": null,
      "downs": 0,
      "name": "t3_1xf72kd",
      "upvote_ratio": 0.7,
      "ups": 4,
      "total_awards_received": 0,
      "score": 4,
      "created": 1792946317,
      "created_utc": 1792946317,
      "created_at_iso": "2026-10-25T16:38:37.000Z",
      "num_comments": 0,
      "url": "https://packagemain.tech/p/golang-optimizations-for-highvolume",
      "permalink": "/r/golang/comments/1xf72kd/golang_optimizations_for_highvolume_services/",
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "domain": "packagemain.tech",
      "subreddit_id": "t5_2rc7j",
      "post_hint": "link"
    },
    {
      "id": "1xf4qiw",
      "author": "HospitalImaginary483",
      "author_fullname": "t2_jwvrvihjg",
      "subreddit": "golang",
      "title": "A comprehensive SMTP toolkit and library for Go",
      "link_flair_text": null,
      "selftext": null,
      "selftext_html": null,
      "downs": 0,
      "name": "t3_1xf4qiw",
      "upvote_ratio": 0.6,
      "ups": 1,
      "total_awards_received": 0,
      "score": 1,
      "created": 1792940793,
      "created_utc": 1792940793,
      "created_at_iso": "2026-10-25T15:06:33.000Z",
      "num_comments": 0,
      "url": "https://github.com/synqronlabs/raven",
      "permalink": "/r/golang/comments/1xf4qiw/a_comprehensive_smtp_toolkit_and_library_for_go/",
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "domain": "github.com",
      "subreddit_id": "t5_2rc7j",
      "post_hint": "link"
    }
  ],
  "after": "t3_1x9sf97"
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

`posts` içinde sayfa başına yaklaşık 24 gönderi döner. Sonraki sayfa için yanıttaki `after` değerini `after` parametresiyle geri gönderin; son sayfada null olur. Boş bir sayfa 0 kredi karşılığında `posts: []` döndürür. Bilinmeyen bir subreddit ücretsiz bir 404'tür; tanınmayan bir `sort` veya `timeframe` ya da gönderi id'si olmayan bir `after` ücretsiz bir 400 döndürür.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.