{
  "openapi": "3.0.1",
  "info": {
    "title": "Reddit Scraper - Posts, Comments, Search + AI Analysis ✅",
    "description": "Scrape any subreddit, search across all of Reddit, and pull complete comment threads with every reply intact. Also grabs video transcripts and subreddit profiles. Optional AI sentiment and pain-point analysis with your own key. No Reddit account, no login, no cookies, no run-start fee.",
    "version": "0.0",
    "x-build-id": "9spwLzmK3By5Qeb9A"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/unseenuser~Reddit-Scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-unseenuser-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/unseenuser~Reddit-Scraper/runs": {
      "post": {
        "operationId": "runs-sync-unseenuser-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/unseenuser~Reddit-Scraper/run-sync": {
      "post": {
        "operationId": "run-sync-unseenuser-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": "1. What do you want to collect?",
            "enum": [
              "subreddit_posts",
              "reddit_search",
              "post_comments",
              "subreddit_search",
              "subreddit_info",
              "post_transcript"
            ],
            "type": "string",
            "description": "Choose the job. Whatever you pick here decides what to paste into the box below - the option text tells you which. Example: pick \"Posts from a subreddit\" and paste r/SaaS.",
            "default": "subreddit_posts"
          },
          "targets": {
            "title": "2. Paste what you want to look at (one per line)",
            "type": "array",
            "description": "The option you chose above tells you what belongs here. Subreddit names work with or without r/ (r/SaaS, /r/SaaS and SaaS are all fine). For comments and transcripts paste the full post link. Example: r/SaaS",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "timeRange": {
            "title": "3. Which results, and from when?",
            "enum": [
              "hot-now",
              "newest",
              "rising",
              "top-past-hour",
              "top-today",
              "top-this-week",
              "top-this-month",
              "top-this-year",
              "top-all-time",
              "controversial-today",
              "controversial-all-time",
              "most-relevant",
              "most-comments"
            ],
            "type": "string",
            "description": "Sets the ranking and the time window in one choice, so you never have to match two settings together. Example: \"Top of this week\" gives the week's best posts. Used by posts from a subreddit and by both searches. Comment threads pass it on as the requested comment order. Subreddit profiles and video transcripts ignore it completely. No single Reddit endpoint supports all of these options, so a choice it cannot accept is swapped for the closest one that works - \"most argued about\" becomes \"top\" on a subreddit, for instance - and the run log names any swap it made.",
            "default": "top-this-week"
          },
          "limit": {
            "title": "4. How many results? (0 = every result available)",
            "minimum": 0,
            "type": "integer",
            "description": "0 means everything available. Any number is an exact cap on how many results you get back. Safety ceilings apply behind the scenes (10,000 posts or comments per search); go over one and the run tells you in the log rather than quietly cutting your results. On the Apify free plan a run returns at most 5 results whatever you set here.",
            "default": 0
          },
          "keywords": {
            "title": "🔍 Search inside subreddits - the words to find",
            "type": "array",
            "description": "Only used by the \"Search inside subreddits\" job. The words you are hunting for, inside the subreddits you pasted above. Example: pricing",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeSearchComments": {
            "title": "🔍 Search inside subreddits - also return matching comments",
            "type": "boolean",
            "description": "Reddit sends matching comments back together with the matching posts, so one search gives you both. Example: searching \"pricing\" in r/SaaS returns both posts and comments that mention it.",
            "default": true
          },
          "includeSearchMedia": {
            "title": "🔍 Search inside subreddits - also return matching images and videos",
            "type": "boolean",
            "description": "Images and videos come back from the same search. Off by default because most people want text. Turn it on when you are researching visual content.",
            "default": false
          },
          "commentDepth": {
            "title": "💬 Comments on a post - how deep into reply chains? (0 = follow every reply)",
            "minimum": 0,
            "type": "integer",
            "description": "0 follows every reply chain to the end. A number stops after that many levels. Example: 2 gives you top-level comments and their direct replies. A ceiling of 20 levels applies.",
            "default": 0
          },
          "transcriptLanguage": {
            "title": "🎬 Video transcript - language",
            "enum": [
              "en",
              "es",
              "pt",
              "fr",
              "de",
              "it",
              "nl",
              "sv",
              "no",
              "da",
              "fi",
              "pl",
              "cs",
              "ru",
              "uk",
              "tr",
              "ar",
              "he",
              "hi",
              "ja",
              "ko",
              "zh",
              "id",
              "vi",
              "th"
            ],
            "type": "string",
            "description": "The language the captions are in. Most Reddit videos are English. Example: choose German for a video from a German subreddit.",
            "default": "en"
          },
          "dateRange": {
            "title": "How far back to look",
            "enum": [
              "",
              "1h",
              "24h",
              "3d",
              "7d",
              "14d",
              "30d",
              "3mo",
              "6mo",
              "1y"
            ],
            "type": "string",
            "description": "The quick way to limit results by age. Example: choose \"Last 7 days\" for a weekly report. For an exact window like 1 March to 15 March, leave this on \"Any time\" and fill in the two boxes below instead.",
            "default": ""
          },
          "includeNSFW": {
            "title": "Include adult content",
            "type": "boolean",
            "description": "On by default. Turn off to drop anything Reddit marks as over-18. Example: turn off when the results are going into a work report.",
            "default": true
          },
          "enrichments": {
            "title": "Add AI analysis to every result",
            "type": "array",
            "description": "Leave empty to skip AI analysis. Tick any combination and each post and comment comes back already analysed. Needs your own Claude API key in the next box. Example: tick \"How they feel about it\" and \"Problems they mention\" to find out what people dislike about a product and how strongly.",
            "items": {
              "type": "string",
              "enum": [
                "sentiment",
                "intent",
                "painPoints",
                "featureRequests",
                "buyingIntent"
              ],
              "enumTitles": [
                "😀 How they feel about it (positive, negative, and the emotion)",
                "🎯 Why they posted (a question, a complaint, a recommendation...)",
                "🔧 Problems they mention, quoted word for word",
                "💡 Things they wish existed, quoted word for word",
                "💰 How close they sound to buying"
              ]
            },
            "default": []
          },
          "llmApiKey": {
            "title": "Your Claude API key",
            "type": "string",
            "description": "Only needed if you ticked something above. Get one at console.anthropic.com. Your key is used for this run and never stored. Example: a key starting sk-ant-"
          },
          "llmModel": {
            "title": "Which Claude model",
            "enum": [
              "claude-haiku-4-5-20251001",
              "claude-sonnet-5",
              "claude-opus-5"
            ],
            "type": "string",
            "description": "Haiku 4.5 is the fastest and handles sentiment and intent on short Reddit text. Sonnet 5 and Opus 5 are stronger at extracting nuanced quotes word for word.",
            "default": "claude-haiku-4-5-20251001"
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}