{
  "openapi": "3.0.1",
  "info": {
    "title": "Reddit Profile Scraper — $0.8/1K · Search & Comments",
    "description": "Search Reddit posts by keyword or community, collect public discussions, and research profiles. Source-visible text, authors, dates and IDs; explicit coverage diagnostics. $0.8/1K records plus start and usage; optional Residential Proxy costs extra.",
    "version": "2.6",
    "x-build-id": "MDURmaYtOTRpKmHDC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/apivault_labs~reddit-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-apivault_labs-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/apivault_labs~reddit-scraper/runs": {
      "post": {
        "operationId": "runs-sync-apivault_labs-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/apivault_labs~reddit-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-apivault_labs-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",
        "properties": {
          "mode": {
            "title": "What do you want to collect?",
            "enum": [
              "profiles",
              "search",
              "discussion",
              "subreddit",
              "user_content"
            ],
            "type": "string",
            "description": "Choose a collection task. profiles retains existing inputs. New archive feed/user modes require sourceMode=archive. Live availability is source-dependent.",
            "default": "profiles"
          },
          "sourceMode": {
            "title": "Data source",
            "enum": [
              "live",
              "archive"
            ],
            "type": "string",
            "description": "Explicit source selection. Archive records disclose source and archived timestamps. No silent fallback. Live RSS/JSON may be unavailable.",
            "default": "live"
          },
          "usernames": {
            "title": "Reddit usernames",
            "type": "array",
            "description": "One or many accounts: plain username ('nasa'), 'u/nasa', or a full profile URL (https://www.reddit.com/user/nasa/). Bulk lists supported вЂ” one profile record per account.",
            "items": {
              "type": "string"
            }
          },
          "maxPosts": {
            "title": "Max posts per profile",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Latest submissions to collect per account (0 = profile only). Each collected post is a billable dataset item.",
            "default": 25
          },
          "maxComments": {
            "title": "Max comments per profile",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Latest comments to collect per account (0 = none). Each collected comment is a billable dataset item.",
            "default": 25
          },
          "searchQueries": {
            "title": "Search phrases",
            "type": "array",
            "description": "Search mode only. 1вЂ“10 phrases; results deduplicated across phrases.",
            "items": {
              "type": "string"
            }
          },
          "searchSubreddit": {
            "title": "Search within a community",
            "type": "string",
            "description": "Live search: optional community. Archive search: an explicit community scope is required; searchSubreddits supports several."
          },
          "searchSort": {
            "title": "Search ordering",
            "enum": [
              "new",
              "relevance",
              "top",
              "comments"
            ],
            "type": "string",
            "description": "Live search only. Archive uses archiveSort by creation time and does not reproduce Reddit ranking.",
            "default": "new"
          },
          "discussionUrls": {
            "title": "Discussion URLs",
            "type": "array",
            "description": "Discussion mode only. 1вЂ“10 public HTTPS Reddit post URLs. Full comment coverage is not guaranteed.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Total discovery records",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Global delivered rows (posts plus comments), not per query. Live max1000; archive max10000. Result and platform fees apply.",
            "default": 5
          },
          "maxThreadComments": {
            "title": "Comments per discussion",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Per discussion comment cap. Archive0 disables comments; live max100. Does not override global result/request/deadline caps.",
            "default": 20
          },
          "pageSize": {
            "title": "Source page or initial tree size",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Requested source page size. Archive discussion: initial tree limit. Sources can return fewer useful rows.",
            "default": 10
          },
          "maxPages": {
            "title": "Maximum pages per query/target/type",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Page cap per query/target/type. Live1..20; archive1..50.",
            "default": 2
          },
          "sourceTimeoutSeconds": {
            "title": "Source time budget (seconds)",
            "minimum": 10,
            "maximum": 600,
            "type": "integer",
            "description": "Bounded source collection time; archive10..600s, live10..300s.",
            "default": 90
          },
          "requestRetries": {
            "title": "Retries for transient source errors",
            "minimum": 0,
            "maximum": 2,
            "type": "integer",
            "description": "0..2 bounded retries. Live: transient errors including429. Archive: network/server/explicit query timeouts only;429 stops collection. Global request/time caps still apply.",
            "default": 1
          },
          "after": {
            "title": "Continue after post ID (advanced)",
            "type": "string",
            "description": "Optional t3_ fullname cursor for search. Not a guarantee of additional source results."
          },
          "proxyMode": {
            "title": "Discovery network access",
            "enum": [
              "direct",
              "residential"
            ],
            "type": "string",
            "description": "Optional for search and discussion only. Residential bandwidth is charged by Apify separately and availability depends on your account. Does not guarantee Reddit access.",
            "default": "direct"
          },
          "subreddits": {
            "title": "Community names",
            "type": "array",
            "description": "Profiles: discover authors. Archive subreddit/search: up to10 community names, r/name or URLs.",
            "items": {
              "type": "string"
            }
          },
          "subredditSort": {
            "title": "Subreddit listing",
            "enum": [
              "hot",
              "new",
              "top",
              "rising"
            ],
            "type": "string",
            "description": "Which listing to pull authors from: Hot (active now), New (fresh posters), Top, Rising.",
            "default": "hot"
          },
          "postsPerSubreddit": {
            "title": "Posts to scan per subreddit",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many posts to scan for authors per subreddit (1-100).",
            "default": 50
          },
          "minKarma": {
            "title": "Lead filter: min total karma",
            "minimum": 0,
            "type": "integer",
            "description": "Skip accounts below this karma (0 = off). Applied when Reddit OAuth enhanced mode is available.",
            "default": 0
          },
          "minAccountAgeDays": {
            "title": "Lead filter: min account age (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Skip fresh accounts (0 = off). Applied when Reddit OAuth enhanced mode is available.",
            "default": 0
          },
          "activeWithinDays": {
            "title": "Lead filter: active within N days",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only accounts that posted or commented in the last N days (0 = off).",
            "default": 0
          },
          "hasContactInfoOnly": {
            "title": "Lead filter: only accounts with contact info",
            "type": "boolean",
            "description": "Keep only profiles where an email or social link was found (bio/posts/comments).",
            "default": false
          },
          "trackChanges": {
            "title": "Track changes between runs",
            "type": "boolean",
            "description": "Adds karmaDelta and previousScrapedAt to each profile by comparing with your previous runs of the same accounts.",
            "default": false
          },
          "contentType": {
            "title": "Post/comment content",
            "enum": [
              "posts",
              "comments",
              "both"
            ],
            "type": "string",
            "description": "Archive search and user content. Both processes posts before comments under one global maxResults cap.",
            "default": "posts"
          },
          "searchSubreddits": {
            "title": "Archive search communities",
            "type": "array",
            "description": "Required for archive search: up to 10 names, r/name or Reddit community URLs. Archive keyword search is scoped, not a global Reddit ranking.",
            "items": {
              "type": "string"
            }
          },
          "targetsText": {
            "title": "Paste a list or single-column CSV",
            "type": "string",
            "description": "Alternative archive targets: post URLs/IDs for discussion, communities for subreddit, usernames for user_content. Up to 1 MB; URL/PostID/Subreddit/Username header supported."
          },
          "archiveSort": {
            "title": "Archive date order",
            "enum": [
              "new",
              "old"
            ],
            "type": "string",
            "description": "Search/feed/user only: creation date descending or ascending. Discussion uses archive tree order. Not hot/top/relevance ranking.",
            "default": "new"
          },
          "postedAfter": {
            "title": "Created on or after (UTC)",
            "type": "string",
            "description": "Archive: ISO date/time or epoch seconds. Filters posts for discussions before comments are fetched; filters each row in search/feed/user."
          },
          "postedBefore": {
            "title": "Created before (UTC)",
            "type": "string",
            "description": "Exclusive upper creation-date bound in archive mode."
          },
          "maxAgeHours": {
            "title": "Created within last N hours",
            "minimum": 0,
            "maximum": 87600,
            "type": "integer",
            "description": "Archive creation-time filter, 0=off. Does not make an archived observation live.",
            "default": 0
          },
          "expandAllComments": {
            "title": "Expand archived collapsed replies",
            "type": "boolean",
            "description": "Archive discussion: initial tree is capped by pageSize. Fetch additional listed collapsed IDs within all caps. Not all live comments are guaranteed.",
            "default": false
          },
          "postsOnly": {
            "title": "Post rows without comments",
            "type": "boolean",
            "description": "Archive discussion: return posts only. maxThreadComments=0 also disables comment collection.",
            "default": false
          },
          "includeComments": {
            "title": "Add archived comments to discovered posts",
            "type": "boolean",
            "description": "Archive search/subreddit: collect discussions after post discovery if the global maxResults has room. Start with maxPages=1 and pageSize smaller than maxResults.",
            "default": false
          },
          "maxDepth": {
            "title": "Maximum archived comment depth",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Post=0; direct replies=1. Unknown depth stays null; no guessed ancestry.",
            "default": 100
          },
          "maxRequests": {
            "title": "Maximum archive requests",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Global archive request cap. Requests are paced serially; HTTP429 respects the reset and stops collection.",
            "default": 20
          },
          "skipPreviouslyScraped": {
            "title": "Skip previously delivered archive records",
            "type": "boolean",
            "description": "Requires your historyStoreName. Same record IDs are skipped across searches/tasks using that store. Only delivered rows are recorded; one run at a time.",
            "default": false
          },
          "historyStoreName": {
            "title": "Your named delivery history store",
            "type": "string",
            "description": "Your account key-value store name, required for skipPreviouslyScraped. Up to 100,000 IDs; do not share a name between unrelated users. Concurrent runs on one history are unsupported."
          },
          "feedback": {
            "title": "Optional feedback for the maintainer",
            "type": "string",
            "description": "Optional note retained in your run input. Describe missing fields/results; for a response open the Issues tab. Does not change collection."
          },
          "searchField": {
            "title": "Archive post text to search",
            "enum": [
              "title",
              "body",
              "both"
            ],
            "type": "string",
            "description": "Archive bounded scan: match title/body/both for posts; comment search always scans body. Supports documented local Boolean/phrase expressions; not live Reddit ranking.",
            "default": "title"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}