You can access the Reddit Scraper (Search, Post Detail, Comments) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "tELRsrV1MZx9zsyPn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ryyos~reddit-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ryyos-reddit-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/ryyos~reddit-scraper/runs": {
      "post": {
        "operationId": "runs-sync-ryyos-reddit-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/ryyos~reddit-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-ryyos-reddit-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "postDetail",
              "comments"
            ],
            "type": "string",
            "description": "Pilih jenis data yang mau diambil. Field lain di bawah cuma relevan sesuai mode yang dipilih (lihat prefix mode di tiap description) - Apify input schema tidak mendukung show/hide otomatis, semua field tetap tampil.",
            "default": "search"
          },
          "query": {
            "title": "Search keyword",
            "type": "string",
            "description": "(mode: search) Kata kunci pencarian, sama seperti mengetik di kolom pencarian reddit.com."
          },
          "maxItems": {
            "title": "Maksimum hasil",
            "minimum": 1,
            "type": "integer",
            "description": "(mode: search) Jumlah maksimum post yang diambil.",
            "default": 25
          },
          "maxPages": {
            "title": "Maksimum halaman pencarian",
            "minimum": 1,
            "type": "integer",
            "description": "(mode: search) Batas jumlah request pagination (tiap halaman ambil beberapa post). Dihentikan lebih awal kalau maxItems sudah tercapai atau Reddit tidak lagi mengembalikan cursor berikutnya.",
            "default": 3
          },
          "postUrl": {
            "title": "URL atau permalink post",
            "type": "string",
            "description": "(mode: postDetail, comments) URL lengkap atau permalink post, misal https://www.reddit.com/r/starterpacks/comments/lyub6f/playing_minecraft_at_12_years_old_starter_pack/ - bisa disalin dari field \"url\" hasil mode search."
          },
          "commentSort": {
            "title": "Urutan komentar",
            "enum": [
              "confidence",
              "top",
              "new",
              "controversial",
              "qa",
              "old"
            ],
            "type": "string",
            "description": "(mode: comments) Urutan pengambilan komentar.",
            "default": "confidence"
          },
          "maxComments": {
            "title": "Maksimum komentar",
            "minimum": 1,
            "type": "integer",
            "description": "(mode: comments) Jumlah maksimum komentar yang diambil (termasuk lewat pagination \"load more\").",
            "default": 100
          },
          "maxCommentPages": {
            "title": "Maksimum halaman \"load more comments\"",
            "minimum": 1,
            "type": "integer",
            "description": "(mode: comments) Batas jumlah request pagination tambahan untuk memuat komentar lanjutan.",
            "default": 5
          },
          "cookieHeader": {
            "title": "Cookie header (opsional)",
            "type": "string",
            "description": "(semua mode, opsional) Isi header Cookie mentah hasil salin dari devtools browser (login ke reddit.com, buka tab Network, salin header 'cookie' dari salah satu request). Meningkatkan keberhasilan lolos dari verifikasi/anti-bot Reddit. Kalau kosong, coba diambil dari environment variable REDDIT_COOKIE, lalu fallback ke request tanpa cookie."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "(semua mode, opsional) Pakai Apify Proxy supaya request tidak selalu keluar dari IP yang sama. Reddit menerapkan anti-bot yang cukup ketat, proxy direkomendasikan untuk pemakaian lebih dari sesekali.",
            "default": {
              "useApifyProxy": false
            }
          },
          "requestDelaySecs": {
            "title": "Delay antar request (detik)",
            "minimum": 0,
            "type": "number",
            "description": "(semua mode) Jeda antar request pagination, untuk mengurangi risiko rate-limit/block dari Reddit.",
            "default": 1.5
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Reddit Scraper (Search, Post Detail, Comments) OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Reddit Scraper (Search, Post Detail, Comments) from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Reddit Scraper (Search, Post Detail, Comments) API in Python

Reddit Scraper (Search, Post Detail, Comments) API in JavaScript

Reddit Scraper (Search, Post Detail, Comments) API through CLI

Reddit Scraper (Search, Post Detail, Comments) API

Reddit Search Scraper 2026

devcake/reddit-search-scraper

Find viral content ideas, and research niche communities. Extract Reddit posts, comments, and discussion data from search queries.

devcake

RedNote / Xiaohongshu Scraper — Search, Posts, Users, Comments

dltik/rednote-xiaohongshu-scraper

All-in-one RedNote (Xiaohongshu) scraper: search by keyword, fetch post details, user posts, comments. Get title, content, images, hashtags, likes, collects, comments count, author. China's #1 lifestyle platform, 250M MAU. Cookie-based, $0.005/result.

Walid

121

Reddit Post Scraper — Details by URL or ID

toolzerhub/reddit-post-scraper

Fetch complete Reddit post records by post ID or permalink URL, or batch multiple comma-separated post IDs in one run. Export structured post, author, content, and engagement data.

ToolzerHub

Cheapest Reddit Scraper API

scoutlayer/cheapest-reddit-scraper-api

Scrape Reddit subreddit posts, post details, comments, search results, and user profiles via the public JSON API. Supports pagination, multiple targets per run, and configurable sort orders.

ScoutLayer

5.0

(2)

Reddit User Profile Scraper

xtracto/reddit-user-profile-scraper

Get a Reddit user's public profile — karma, account age, premium status, trophies.

Farhan Febrian Nauval

Reddit Post Search

yesintelligent/reddit-post-search

Extract Reddit posts based on keywords, subreddit filters, and sorting options. Find relevant discussions, questions, and content from Reddit communities.

yesintelligent

Reddit Scraper

maximedupre/reddit-scraper

The best Reddit scraper, for both posts & comments.

Maxime Dupré

📚 Goodreads Book Scraper

easyapi/goodreads-book-scraper

Extract comprehensive book data from Goodreads search results. Get detailed information about books, authors, ratings, and more. Perfect for market research, data analysis, and building book recommendation systems. 🔍📚

EasyApi

Reddit Trends Scraper 🔍

easyapi/reddit-trends-scraper

Extract trending posts and discussions from Reddit with advanced filtering capabilities. Scrapes post details, engagement metrics, and user information while handling dynamic content loading.

EasyApi

115

4.9

(2)

Reddit Post Search

datamagnet/reddit-post-searcher

Search Reddit posts by keyword and get a clean list of matching results. Narrow results by subreddit, sort order, and time range to quickly find the most relevant posts.

Datamagnet

Reddit Posts Search Scraper

easyapi/reddit-posts-search-scraper

Extract Reddit posts from search results with rich metadata, including media content, engagement metrics, and community information. Perfect for content research, trend analysis, and social media monitoring across Reddit communities.

EasyApi

625

5.0

(2)