RedditArkib Komuniti2 credits

reddit_search

Cari post dan komen Reddit, atau baca satu thread komen penuh — tanpa menyentuh reddit.com, yang menyekat scraper. Membuat pertanyaan kepada arkib komuniti Arctic Shift dan PullPush: 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

2 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 arkib tertentu: "auto" (menghala dan beralih sandaran secara automatik), "arctic_shift", atau "pullpush" Example: auto

reddit.com menyekat scraping langsung, jadi reddit_search tidak pernah menyentuhnya. Carian berskop subreddit atau pengarang dan mod thread menggunakan arkib Arctic Shift (hampir masa nyata); carian kata kunci merentas seluruh Reddit dihalakan ke PullPush, yang mempunyai jurang yang diketahui dalam arkibnya selepas 2023. Setiap carian mesti menyertakan sekurang-kurangnya satu daripada query, subreddit, atau author. Skor dan bilangan komen bagi kandungan yang berusia kurang daripada ~36 jam mungkin terbaca 0/1 — arkib menangkap kandungan sebaik sahaja ia disiarkan.

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": 2,
  "credits_remaining": 998,
  "processing_time": 850
}

Field Descriptions

data.sourceArkib yang menjawab: arctic_shift (berskop, lebih segar) atau pullpush (carian kata kunci seluruh tapak)

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

credits_used2 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 gunakan source: "pullpush".

Mod Thread melalui PullPush (400 Bad Request)

Mod thread hanya untuk Arctic Shift — source: "pullpush" menyokong carian posts dan comments.

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 dihalakan ke Arctic Shift, yang lebih segar dan lebih boleh dipercayai berbanding laluan seluruh tapak PullPush. Untuk membaca sesuatu perbincangan dari awal hingga akhir, ambil id post daripada hasil carian dan hantarkannya sebagai link_id dengan mode: "thread".

Kos Credit

2 credits

2 credits setiap carian

Kos tetap untuk satu carian atau bacaan thread penuh. Credits dicaj hanya untuk permintaan yang berjaya.

Apa yang Disertakan:

Mod posts, comments, dan thread penuh

Penapis subreddit, pengarang, dan julat tarikh

Pepohon komen bersarang dengan penanda lipatan gaya reddit

Permalink reddit.com penuh dan tarikh ISO pada setiap hasil

Tiada bukti kelayakan API Reddit diperlukan

Cadangan Pelan:

Pelan Free: 1,000 credits percubaan sekali sahaja = 500 carian

Pelan Hobby: 5,000 credits = 2,500 carian ($19/mo)

Pelan Professional: 50,000 credits = 25,000 carian ($99/mo)

Alat Berkaitan

search_web

Cari seluruh web melalui Google atau DuckDuckGo (5 credits)

summarize_content

Ringkaskan thread panjang kepada perkara utama (4 credits)

analyze_content

Sentimen, entiti, dan kata kunci daripada teks thread (3 credits)

deep_research

Penyelidikan berbilang sumber dengan analisis AI (10 credits)

Bersedia untuk mencuba reddit_search? Daftar percuma dan dapatkan 1,000 credits untuk mula menggali perbincangan Reddit.

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

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 arkib tertentu: "auto" (menghala dan beralih sandaran secara automatik), "arctic_shift", atau "pullpush" Example: auto

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": 2,
  "credits_remaining": 998,
  "processing_time": 850
}

Field Descriptions

data.sourceArkib yang menjawab: arctic_shift (berskop, lebih segar) atau pullpush (carian kata kunci seluruh tapak)

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

credits_used2 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 gunakan source: "pullpush".

Mod Thread melalui PullPush (400 Bad Request)

Mod thread hanya untuk Arctic Shift — source: "pullpush" menyokong carian posts dan comments.

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.

Kos Credit

2 credits

2 credits setiap carian

Kos tetap untuk satu carian atau bacaan thread penuh. Credits dicaj hanya untuk permintaan yang berjaya.

Apa yang Disertakan:

Mod posts, comments, dan thread penuh

Penapis subreddit, pengarang, dan julat tarikh

Pepohon komen bersarang dengan penanda lipatan gaya reddit

Permalink reddit.com penuh dan tarikh ISO pada setiap hasil

Tiada bukti kelayakan API Reddit diperlukan

Cadangan Pelan:

Pelan Free: 1,000 credits percubaan sekali sahaja = 500 carian

Pelan Hobby: 5,000 credits = 2,500 carian ($19/mo)

Pelan Professional: 50,000 credits = 25,000 carian ($99/mo)