Subreddit İçinde Arama

GET/v1/reddit/subreddit/search1 kredi

Tek bir subreddit'in gönderilerinde arama yapar ve eşleşen gönderileri döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
subredditzorunlu	string	Subreddit'in adı, örneğin `golang`, ya da URL'si.
queryzorunlu	string	Arama metni, örneğin `generics`.
sortisteğe bağlı	string	Sıralama. Verilmezse Reddit'in varsayılanı kullanılır.Kabul edilen değerler:`relevancehottopnewcomments`
timeframeisteğe bağlı	string	Sonuçları bu zaman aralığındaki gönderilerle sınırlar.Kabul edilen değerler:`allyearmonthweekdayhour`
cursoristeğe bağlı	string	Sonraki sayfayı almak için önceki yanıtın `cursor` değeri.

02İstek

curl "https://api.scrapesocial.ai/v1/reddit/subreddit/search?subreddit=golang&query=generics" \
  -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/search?subreddit=golang&query=generics

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "posts": [
    {
      "id": "1wu2x6h",
      "post_id": "t3_1wu2x6h",
      "author": "fastwind18",
      "author_fullname": "t2_9fm19a80x",
      "subreddit": "golang",
      "title": "Do you use method generics of 1.27 in production ?",
      "selftext": null,
      "selftext_html": null,
      "downs": 0,
      "name": "t3_1wu2x6h",
      "upvote_ratio": null,
      "ups": 58,
      "total_awards_received": null,
      "score": 58,
      "created": 1790769284,
      "created_utc": 1790769284,
      "created_at_iso": "2026-09-30T11:54:44.000Z",
      "num_comments": 40,
      "url": "https://www.reddit.com/r/golang/comments/1wu2x6h/do_you_use_method_generics_of_127_in_production/",
      "permalink": "/r/golang/comments/1wu2x6h/do_you_use_method_generics_of_127_in_production/",
      "thumbnail": null,
      "thumbnail_blurred": false,
      "position": 0,
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "relative_position": 0
    },
    {
      "id": "1vx55je",
      "post_id": "t3_1vx55je",
      "author": "VastDesign9517",
      "author_fullname": "t2_9ntut7nq",
      "subreddit": "golang",
      "title": "What are you gonna use Generic methods for?",
      "selftext": null,
      "selftext_html": null,
      "downs": 0,
      "name": "t3_1vx55je",
      "upvote_ratio": null,
      "ups": 44,
      "total_awards_received": null,
      "score": 44,
      "created": 1787583411,
      "created_utc": 1787583411,
      "created_at_iso": "2026-08-24T14:56:51.000Z",
      "num_comments": 61,
      "url": "https://www.reddit.com/r/golang/comments/1vx55je/what_are_you_gonna_use_generic_methods_for/",
      "permalink": "/r/golang/comments/1vx55je/what_are_you_gonna_use_generic_methods_for/",
      "thumbnail": null,
      "thumbnail_blurred": false,
      "position": 1,
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "relative_position": 1
    }
  ],
  "cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiMVwiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIyXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfN19zY29wZV9zd2l0Y2hlclwiOlwiMFwiLFwic2VjdGlvbl8yX3BpcGVsaW5lXzhfZHluYW1pY18wX3Bvc3Rfc2VhcmNoXCI6XCI3XCIsXCJzZWN0aW9uXzNfcGlwZWxpbmVfMF9zaWRlYmFyX2NvbW11bml0eV9pbmZvXCI6XCIwXCJ9IiwiZXhwZXJpZW5jZV9zZWxlY3Rpb24iOiJw…"
}

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 7 gönderi ve sonraki sayfa için `cursor` parametresiyle geri gönderilecek opak bir `cursor` string'i döner. Arama sonuçlarında gönderi metni yoktur (`selftext` null); `upvote_ratio` ve `total_awards_received` da null gelir. Sonuç bulunamayan bir arama 0 kredi karşılığında `posts: []` 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.