Arama

GET/v1/reddit/search1 kredi

Reddit genelinde arama yapar ve eşleşen gönderileri, `filter=comments` ile ise eşleşen yorumları döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Arama metni, örneğin `golang generics`.
filteristeğe bağlı	string	Neyin aranacağı: gönderiler (`posts` içinde döner) veya yorumlar (`comments` içinde döner).Varsayılan: `posts`Kabul edilen değerler:`postscomments`
sortisteğe bağlı	string	Sıralama. Verilmezse Reddit'in varsayılanı kullanılır.Kabul edilen değerler:`relevancenewtopcomment_count`
timeframeisteğe bağlı	string	Sonuçları bu zaman aralığıyla sınırlar.Kabul edilen değerler:`alldayweekmonthyear`
afteristeğe bağlı	string	Sonraki sayfayı almak için önceki yanıtın `after` değeri.
trimisteğe bağlı	boolean	`true` verilirse her gönderiden bazı alanlar çıkarılır (`post_id`, `created_at_iso`, `permalink`, `thumbnail`, `position` gibi).Varsayılan: `false`

02İstek

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

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "posts": [
    {
      "id": "1nr88zk",
      "post_id": "t3_1nr88zk",
      "author": null,
      "author_fullname": null,
      "subreddit": "golang",
      "title": "my work colleagues use generics everywhere for everything",
      "selftext": null,
      "selftext_html": null,
      "downs": 0,
      "name": "t3_1nr88zk",
      "upvote_ratio": null,
      "ups": 296,
      "total_awards_received": null,
      "score": 296,
      "created": 1758909492,
      "created_utc": 1758909492,
      "created_at_iso": "2025-09-26T17:58:12.000Z",
      "num_comments": 160,
      "url": "https://www.reddit.com/r/golang/comments/1nr88zk/my_work_colleagues_use_generics_everywhere_for/",
      "permalink": "/r/golang/comments/1nr88zk/my_work_colleagues_use_generics_everywhere_for/",
      "thumbnail": null,
      "thumbnail_blurred": false,
      "position": 0,
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "relative_position": 0
    },
    {
      "id": "1h1w0lm",
      "post_id": "t3_1h1w0lm",
      "author": "branh0913",
      "author_fullname": "t2_u7m4j",
      "subreddit": "golang",
      "title": "Do you use generics?  What has been your experience?",
      "selftext": null,
      "selftext_html": null,
      "downs": 0,
      "name": "t3_1h1w0lm",
      "upvote_ratio": null,
      "ups": 31,
      "total_awards_received": null,
      "score": 31,
      "created": 1732800730,
      "created_utc": 1732800730,
      "created_at_iso": "2024-11-28T13:32:10.000Z",
      "num_comments": 56,
      "url": "https://www.reddit.com/r/golang/comments/1h1w0lm/do_you_use_generics_what_has_been_your_experience/",
      "permalink": "/r/golang/comments/1h1w0lm/do_you_use_generics_what_has_been_your_experience/",
      "thumbnail": null,
      "thumbnail_blurred": false,
      "position": 1,
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "relative_position": 1
    }
  ],
  "after": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiMVwiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIyXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfMTFfcXVlcnlfc3VnZ2VzdGlvbnNcIjpcIjZcIixcInNlY3Rpb25fMl9waXBlbGluZV84X2R5bmFtaWNfMF9wb3N0X3NlYXJjaFwiOlwiN1wiLFwic2VjdGlvbl8zX3BpcGVsaW5lXzBfZHluYW1pY18wX3N1YnJlZGRpdF9zZWFyY2hcIjpcIjVcIixcInNlY3Rpb25fM19waXBlbGlu…"
}

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

Sayfa başına yaklaşık 7 gönderi (yorum aramalarında birkaç tane daha) ve sonraki sayfa için `after` parametresiyle geri gönderilecek opak bir `after` string'i döner; sayfalar birbiriyle örtüşebilir. Gönderi sonuçlarında gövde yoktur (`selftext` null); `upvote_ratio` ve `total_awards_received` null gelir. Sonuç bulunamayan bir arama 0 kredi karşılığında boş liste döndürür. Tanınmayan bir `filter`, `sort` veya `timeframe` ü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.