{ "openapi": "3.0.1", "info": { "title": "Patreon Scraper", "description": "[💰 $2.5/1K creators + $0.4/1K posts] Extract Patreon creators and their public posts — patron/member counts, membership tiers, pricing, NSFW flags, plus post titles, likes, comments, and teasers. Paste URLs, search by keyword, or browse a category. For creator research and brand-deal scouting.", "version": "1.0", "x-build-id": "OY5WTaIyuStLM9gAh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~patreon-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-patreon-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/solidcode~patreon-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-patreon-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/solidcode~patreon-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-patreon-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": { "startUrls": { "title": "Patreon URLs or Handles", "type": "array", "description": "Paste one or more Patreon links or handles. Use a creator page (e.g. https://www.patreon.com/PhilosophyTube or just PhilosophyTube) to get that creator and its public posts, or an individual post link (e.g. https://www.patreon.com/posts/title-123456) to get just that post. You can mix both in one list. Leave blank to use the search or category options below.", "items": { "type": "string" } }, "searchQuery": { "title": "Search Keyword", "type": "string", "description": "Find creators by topic, for example 'true crime podcast' or 'watercolor art'. Leave blank if you are using URLs or a category." }, "category": { "title": "Browse a Category", "enum": [ "", "podcasts_and_shows", "music", "visual_arts", "video_games", "tabletop_games", "writing", "handicrafts", "apps_and_software", "social_impact", "lifestyle" ], "type": "string", "description": "Browse top creators in a Patreon category. Each category returns up to roughly 120 of its top creators (a limit set by Patreon's browse listing, not the actor) — to cover more, add a search keyword or paste creator handles alongside it. Leave blank if you are using URLs or a search keyword." }, "includePosts": { "title": "Include Public Posts", "type": "boolean", "description": "Also collect each creator's public posts (title, type, published date, likes, comments, and teaser). Turn this off for faster, cheaper runs when you only need creator profiles and membership tiers.", "default": true }, "maxPostsPerCreator": { "title": "Max Posts Per Creator", "minimum": 0, "type": "integer", "description": "Maximum number of public posts to collect for each creator (newest first). Set to 0 to collect all available posts, up to a safety maximum per creator. Popular creators can have thousands of posts — a limit keeps runs fast and affordable. Each post is returned as its own result. Only applies when 'Include Public Posts' is on.", "default": 20 }, "includeNsfw": { "title": "Include Adult (NSFW) Creators", "type": "boolean", "description": "Include creators marked as adult/NSFW in category results (and in search where Patreon exposes them). Off by default.", "default": false }, "maxResults": { "title": "Max Creators", "minimum": 0, "type": "integer", "description": "Maximum number of creators to collect across all of your URLs, searches, and categories. Set to 0 for no limit. We recommend keeping a limit to control cost. Posts are limited separately by 'Max Posts Per Creator'.", "default": 100 } } }, "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 } } } } } } } } } }