RedditArkib Komuniti5 credits

reddit_search

Cari post dan komen Reddit, atau baca satu thread komen penuh — tanpa menyentuh reddit.com, yang menyekat scraper. Membaca arkib komuniti Arctic Shift: percuma, hampir masa nyata, dan tiada bukti kelayakan API Reddit diperlukan.

Kes Penggunaan

Pemantauan Jenama & Produk

Temui setiap sebutan produk atau syarikat anda di seluruh Reddit, dihadkan kepada subreddit berkaitan atau seluruh tapak

Penyelidikan Pasaran & Sentimen

Gali apa yang diperkatakan pengguna sebenar tentang sesuatu kategori, pesaing, atau masalah dalam komuniti tempat mereka membincangkannya

Pembacaan Thread untuk Ejen AI

Dapatkan satu post berserta keseluruhan pepohon komen bersarangnya dalam satu panggilan — sedia untuk ringkasan atau analisis

Penjejakan Trend Komuniti

Pantau apa yang dibincangkan sesebuah subreddit dalam sesuatu julat tarikh menggunakan penapis after/before

Penyelidikan Pengguna

Dapatkan post atau komen seseorang pengarang tertentu untuk memahami pendapat pakar dan tema berulang

Endpoint

POST/api/v1/tools/reddit_search

Auth Required

1 req/s pada pelan Free

5 credits

Parameters

Name	Type	Required	Default	Description
query	string	Optional	-	Carian kata kunci. Mod posts memadankan title + selftext; mod comments memadankan body. Menyokong "frasa dalam petikan", OR, dan -pengecualian Example: best mechanical keyboard
subreddit	string	Optional	-	Hadkan hasil kepada satu subreddit (dengan atau tanpa awalan r/) Example: MechanicalKeyboards
author	string	Optional	-	Hadkan hasil kepada satu pengarang (dengan atau tanpa awalan u/) Example: spez
mode	string	Optional	posts	Apa yang hendak dicari: "posts" (lalai), "comments", atau "thread" (satu post berserta pepohon komen bersarangnya — memerlukan link_id) Example: thread
link_id	string	Optional	-	ID post (cth. "1twm1zh" atau "t3_1twm1zh") — diperlukan untuk mod thread, penapis pilihan untuk mod comments Example: 1twm1zh
after	string	Optional	-	Hanya kandungan yang disiarkan selepas tarikh ini — ISO 8601, saat epoch, atau ofset seperti "7d" Example: 7d
before	string	Optional	-	Hanya kandungan yang disiarkan sebelum tarikh ini — format sama seperti after Example: 2026-08-01
limit	number	Optional	25	Hasil maksimum, 1-100 (mod thread: bilangan maksimum komen yang dikembalikan) Example: 10
sort	string	Optional	desc	Isih mengikut tarikh post: "desc" (terbaru dahulu) atau "asc" Example: desc
source	string	Optional	auto	Paksa backend tertentu: "auto" (Arctic Shift dahulu, PullPush kedua; carian kata kunci tanpa skop melalui web_discovery dahulu), "arctic_shift" (carian berskop dan thread), "web_discovery" (carian kata kunci seluruh Reddit), atau "pullpush" (sumber kedua automatik; menolak klien automatik sejak Ogos 2026) Example: auto

reddit.com menyekat scraping langsung, jadi reddit_search tidak pernah menyentuhnya. Carian berskop subreddit atau pengarang dan mod thread membaca arkib Arctic Shift (hampir masa nyata). Carian kata kunci merentas seluruh Reddit tidak boleh dilayan terus oleh Arctic Shift — ia menuntut skop — jadi ia dihalakan ke web_discovery dahulu: carian web terhad tapak mencari post yang sepadan, kemudian ID post itu dibaca dari Arctic Shift. Laluan itu memulangkan baris arkib yang sebenar, tetapi terhad kepada 10 post setiap panggilan, menyusunnya mengikut kaitan carian web dan bukan skor atau tarikh, dan tidak boleh menggunakan after/before; respons menyatakannya dalam notes. Apabila Arctic Shift atau web_discovery gagal dalam carian posts atau comments, PullPush dicuba kedua dan respons melaporkannya dalam fallback_used; PullPush menolak klien automatik sejak Ogos 2026, jadi sandaran itu biasanya melaporkan penolakan itu juga. Setiap carian mesti menyertakan sekurang-kurangnya satu daripada query, subreddit, atau author. Skor dan kiraan komen bagi kandungan berumur kurang ~36 jam mungkin terbaca 0/1 — arkib menangkap kandungan pada saat ia dihantar.

Satu backend hanya untuk MCP. Pakej crawlforge-mcp-server yang dihoskan sendiri juga boleh membaca Data API rasmi Reddit (source: "reddit_api") apabila anda menetapkan REDDIT_CLIENT_ID dan REDDIT_CLIENT_SECRET kepada bukti kelayakan aplikasi Reddit anda sendiri — ia memulangkan skor langsung dan pepohon komen yang lengkap atas kuota anda sendiri, dan beralih kepada arkib sebagai sandaran. Endpoint REST ini sengaja tidak menawarkannya: kunci Reddit dikongsi di pihak pelayan akan dikira penggunaan komersial di bawah terma API Reddit. Ambil perhatian juga bahawa Reddit menutup pendaftaran layan diri API pada November 2025, jadi bukti kelayakan baharu melalui proses kelulusan. Carian teks penuh komen dan penapis after/before sentiasa menggunakan arkib, kerana API Reddit tidak menyokong kedua-duanya.

Contoh Permintaan

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/reddit_search \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "mode": "posts",
    "limit": 10
  }'

Contoh Respons

200 OK850ms

{
  "success": true,
  "data": {
    "source": "arctic_shift",
    "mode": "posts",
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "author": null,
    "count": 2,
    "results": [
      {
        "id": "1x2y3z4",
        "title": "What's the best mechanical keyboard for programming in 2026?",
        "author": "keeb_enthusiast",
        "subreddit": "MechanicalKeyboards",
        "created_utc": 1755993600,
        "created_iso": "2026-08-24T00:00:00.000Z",
        "score": 142,
        "num_comments": 87,
        "upvote_ratio": 0.96,
        "flair": "Discussion",
        "over_18": false,
        "selftext": "After five years on membrane boards I finally want to switch...",
        "selftext_truncated": false,
        "url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/",
        "permalink": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/whats_the_best_mechanical_keyboard/"
      }
    ],
    "notes": [
      "Data from the Arctic Shift community archive (arctic-shift.photon-reddit.com), not reddit.com (which blocks scrapers).",
      "Scores and comment counts of content less than ~36h old may read 0/1 — the archive captures content the moment it is posted."
    ],
    "checkedAt": "2026-08-24T14:30:00.000Z"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 850
}

Field Descriptions

data.sourceBackend yang menjawab: arctic_shift (berskop, lebih segar), web_discovery (carian kata kunci seluruh Reddit tanpa skop), atau pullpush (sumber kedua automatik, atau atas permintaan eksplisit)

data.resultsPost atau komen ternormal dengan permalink reddit.com penuh dan tarikh ISO

data.results.selftext_truncatedTeks post/komen dihadkan kepada 2,000 aksara; true apabila dipotong

data.notesKaveat provenans dan kesegaran bagi arkib yang menjawab

data.commentsMod thread: pepohon komen bersarang. Cabang yang dilipat ialah stub {more_count, more_ids}: more_count ialah bilangan komen yang disembunyikannya, termasuk balasan; more_ids hanya menyenaraikan balasan langsung yang tersembunyi, jadi ia boleh lebih pendek daripada more_count

data.comment_countMod thread: komen dalam data.comments pada setiap kedalaman, tidak termasuk stub — paling banyak limit

data.comments_collapsedMod thread: jumlah more_count setiap stub — komen yang disimpan arkib untuk thread ini tetapi ditinggalkan oleh respons. comment_count + comments_collapsed ialah apa yang disimpan arkib; post.num_comments ialah jumlah Reddit sendiri ketika arkib membaca post itu, jadi ia boleh lebih tinggi (komen yang dipadam, dibuang atau belum diarkibkan) atau lebih rendah (komen yang dibuat selepas bacaan itu)

credits_used5 credits tetap setiap carian atau bacaan thread

processing_timeCarian arkib biasanya selesai dalam masa kurang daripada 2 saat

Pengendalian Ralat

Skop Carian Hilang (400 Bad Request)

Mod posts dan comments memerlukan sekurang-kurangnya satu daripada query, subreddit, atau author. Mod thread memerlukan link_id.

Carian Arctic Shift Tanpa Skop (400 Bad Request)

Arctic Shift tidak boleh membuat carian kata kunci merentas seluruh Reddit. Tambahkan skop subreddit atau author, atau buang source dan biarkan auto menghalakan pertanyaan itu ke web_discovery.

Mod Thread pada Backend Bukan Arctic (400 Bad Request)

Mod thread hanya untuk Arctic Shift. source: "pullpush" menyokong carian posts dan comments, dan source: "web_discovery" hanya melayan carian kata kunci tanpa skop.

Penapis Tarikh Tidak Sah (400 Bad Request)

after/before mestilah ISO 8601, saat epoch, atau ofset seperti "7d".

Arkib Tidak Tersedia (502 Bad Gateway)

Kedua-dua arkib komuniti gagal atau sedang mengehadkan kadar. Mesej ralat menyertakan sebab bagi setiap arkib. Tiada credits dicaj — cuba semula sebentar lagi.

Petua Pro:

Hadkan carian kepada satu subreddit atau pengarang apabila boleh. Pertanyaan berskop terus ke Arctic Shift, di mana limit mencapai 100 dan after/before berfungsi; yang tanpa skop menjalankan web_discovery, yang memulangkan paling banyak 10 post dan mengabaikan penapis tarikh. Untuk membaca perbincangan dari mula ke akhir, ambil id post daripada hasil carian dan hantarkannya sebagai link_id dengan mode: "thread".