# Patreon Scraper – Profiles, Tiers & Posts (`bovi/patreon-scraper`) Actor Scrape **Patreon creator profiles**, **membership tiers**, **patron counts**, **earnings estimates**, and **public posts with media** — no login, no API key, no proxy. Four modes: creator, posts, search, post-by-URL. Data from Patreon's own JSON:API, with an SSR fallback for resilience. - **URL**: https://apify.com/bovi/patreon-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Patreon Scraper – Creator Profiles, Tiers, Earnings & Posts Scrape **Patreon creator profiles**, **membership tiers**, **patron counts**, **earnings estimates**, and **public posts with media** — no login, no API key, no proxy required. Four modes cover the full creator-intelligence workflow: profile lookup, post listing, keyword search, and single-post lookup. Data is fetched from Patreon's own internal JSON:API (the same endpoints the Patreon website uses), confirmed working as of 2026-06-04. Whether you need a creator's patron count, tier pricing and a monthly-revenue estimate for market research, a catalog of public posts **with video and embed URLs** for content analysis, or a list of creators for a niche keyword — this actor delivers structured, ready-to-use records at **$1.50 per 1,000 results**, roughly **half the price** of comparable Patreon scrapers on the Store. --- ### What data you get from Patreon #### Creator profile mode (`creator`) One record per Patreon URL or vanity name: - `creator_name`, `vanity`, `url`, `avatar_url`, `cover_url`, `pledge_url` - `patron_count` — total patrons (null for ~25% of creators who set earnings private) - `paid_member_count` — paying patrons only - `tier_count` + `tiers[]` — published membership tiers with title, **USD price**, description, image, and shipping flag - `min_tier_cents` / `max_tier_cents` — entry and top price points at a glance - **`est_monthly_cents`** — conservative monthly-revenue estimate (`paid_member_count × cheapest paid tier`) - `creation_count` — total posts ever published - `is_nsfw`, `is_monthly`, `currency` - `summary`, `one_liner`, `creation_name` - `social_links` — connected YouTube, Twitter, Discord, Instagram, etc. - `created_at`, `published_at` #### Post listing mode (`posts`) One record per post for each creator URL: - `title`, `post_type` (podcast / video_embed / image / link / text), `published_at_post`, `edited_at` - `is_public` and `is_paid` — reliable paywall detection (we use the `is_paid` flag, not just minimum pledge, so locked podcast posts are classified correctly) - `teaser_text`, `content_text` — free preview and public body text (HTML stripped) - `like_count`, `comment_count` - `post_url` - **`media`** — a single normalized media block per post: `image_url`, `thumbnail_url`, `video_url` (native Patreon HLS stream) + `video_duration_sec`, and `embed_url` / `embed_provider` / `embed_title` (YouTube, Vimeo, Spotify). Most competitors return only a thumbnail. #### Search mode (`search`) One record per search result: `creator_name`, `vanity`, `url`, `avatar_url`, `patron_count` (when public), `is_nsfw`, `summary`, `creation_name`. #### Post-by-URL mode (`postByUrl`) Pass a post link or ID and get one fully-detailed post record — handy for agents resolving a single shared Patreon link. All records include `parse_confidence` (0.0–1.0), `warnings`, and `data_source` (`json_api` or `ssr_fallback`) for data-quality monitoring. --- ### Who uses Patreon scraper data? - **Creator economy researchers** — track patron counts, tier pricing, and revenue estimates across niches - **Content agencies** — find creators by keyword for sponsorship or collaboration outreach - **Market intelligence tools** — benchmark membership tier structures and pricing across categories - **Competitive analysis** — compare post frequency, media mix, and audience size for similar creators - **Newsletter and podcast analysts** — extract public post titles, media links, and engagement signals at scale --- ### How to use #### Get creator profile + earnings estimate ```json { "mode": "creator", "creatorUrls": ["https://www.patreon.com/cgpgrey", "cortexfm", "darknetdiaries"] } ```` #### Get public posts with media for a creator ```json { "mode": "posts", "creatorUrls": ["darknetdiaries"], "maxItems": 50 } ``` #### Search creators by keyword ```json { "mode": "search", "searchQuery": "true crime podcast", "maxItems": 30 } ``` #### Look up a single post by URL ```json { "mode": "postByUrl", "postUrls": ["https://www.patreon.com/posts/some-title-141115192"] } ``` *** ### Input parameters | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `creator` | `creator`, `posts`, `search`, or `postByUrl` | | `creatorUrls` | string\[] | — | Patreon URLs or vanity names (for `creator` / `posts` modes) | | `postUrls` | string\[] | — | Patreon post URLs or IDs (for `postByUrl` mode) | | `searchQuery` | string | — | Keyword query (for `search` mode) | | `maxItems` | integer | 100 | Max records returned. In `posts` mode: max posts per creator | | `proxyConfiguration` | object | off | Optional Apify Proxy — not needed for normal runs | *** ### Why this beats competitors Most Patreon scrapers on the Store require login credentials, rely on brittle HTML selectors that break after every UI update, return only a thumbnail for posts, or charge $3–$5 per 1,000 results. This actor: - **Half the price** — **$1.50 / 1,000 results** vs the $3–$5 typical of comparable actors. - Uses **Patreon's own JSON:API** — not HTML scraping. Structural, not presentational — resistant to redesigns. - **Rich media block** on every post — native video stream URL + duration, external embed (YouTube/Vimeo/Spotify) with title, and image/thumbnail URLs. Not just a thumbnail. - **Earnings estimate** + entry/top tier price points — instant market sizing per creator. - **Built-in B-plan** — if Patreon ever changes the JSON:API, the actor automatically falls back to parsing the public creator page's embedded data, so your runs keep producing records (flagged via `data_source`). - **No login required** — no credential management, no account risk. - **`curl_cffi` Chrome TLS impersonation** — passes Patreon's fingerprint check without a proxy; auto-rotates the Apify IP on rate-limit if you enable proxy for high-volume runs. - **`parse_confidence` field** on every record — you know exactly how complete each result is. - **PPE pricing** — you pay per result, nothing for failed or skipped lookups. *** ### FAQ **Does it require a Patreon account or login?** No. All data is fetched from Patreon's public JSON:API — no credentials, no cookies, no authentication. **Can it get patron counts and earnings for private creators?** Patron count is null for creators who set their earnings to private (~25%). `est_monthly_cents` is a conservative estimate derived from `paid_member_count × cheapest paid tier` — a floor, not exact revenue, and only present when both inputs are public. **Can it get paid/exclusive post content?** No. Only publicly accessible post bodies are returned. `is_public=false` / `is_paid=true` marks paywalled posts; their locked content is not scraped, but title, type, media preview, and engagement counts still come through. **Does it return post media?** Yes. Each post carries a `media` block with image, native video (HLS stream) + duration, and external embed URLs (YouTube, Vimeo, Spotify). **Does it need a proxy?** No. The actor uses `curl_cffi` Chrome TLS impersonation and works on datacenter IPs. Enable Apify Residential proxy only for very high-volume runs that may trigger rate limits — the actor then rotates the exit IP automatically. **What is `parse_confidence` / `data_source`?** `parse_confidence` is a 0.0–1.0 completeness score per record. `data_source` is `json_api` for normal runs or `ssr_fallback` when the resilience fallback produced the record. *** ### Pricing **$1.50 per 1,000 results** (PPE — Pay Per Event). Charged per record pushed, after the record is stored. Failed lookups and skipped items are never charged. ### Legal This actor scrapes publicly available data from Patreon using the same API endpoints the Patreon website calls. No authentication is used. Use responsibly and in accordance with Patreon's Terms of Service. # Actor input Schema ## `mode` (type: `string`): What to scrape. 'creator' fetches campaign info + tiers + earnings estimate for one or more Patreon creators. 'posts' fetches the public post list (with media URLs) for a creator's campaign. 'search' finds creators by keyword. 'postByUrl' fetches a single post by its URL or ID. ## `creatorUrls` (type: `array`): Patreon creator page URLs or vanity names. Used in 'creator' and 'posts' modes. Accepts full URLs (https://www.patreon.com/cgpgrey) or bare vanity names (cgpgrey). Each item produces one campaign record ('creator' mode) or a batch of post records ('posts' mode). ## `postUrls` (type: `array`): Patreon post URLs or numeric post IDs. Used in 'postByUrl' mode only. Example: https://www.patreon.com/posts/some-title-141115192. Each item produces one post record with full media details. ## `searchQuery` (type: `string`): Keyword to search Patreon for creators. Used in 'search' mode only. Example: 'true crime podcast' returns matching campaign pages ranked by Patreon's own relevance algorithm. ## `maxItems` (type: `integer`): Maximum number of records to return. In 'creator' mode: max campaigns fetched per vanity/URL. In 'posts' mode: max posts fetched per creator (Patreon paginates 20 at a time). In 'search' mode: max search results returned. Keep low (20–100) for quick agent lookups; raise to 500+ for bulk exports. ## `proxyConfiguration` (type: `object`): Optional Apify Proxy. Leave OFF — the actor reaches Patreon's JSON:API directly with browser TLS impersonation and needs no proxy for normal runs. Enable Apify Proxy (RESIDENTIAL group) only if you push very high volume and start seeing rate-limit (HTTP 429) warnings; the actor then rotates the exit IP automatically on retry. The buyer's Apify account is billed for any proxy usage. ## Actor input object example ```json { "mode": "creator", "creatorUrls": [ "https://www.patreon.com/cgpgrey" ], "searchQuery": "true crime podcast", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "creator", "creatorUrls": [ "https://www.patreon.com/cgpgrey" ], "searchQuery": "true crime podcast", "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/patreon-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "creator", "creatorUrls": ["https://www.patreon.com/cgpgrey"], "searchQuery": "true crime podcast", "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("bovi/patreon-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "creator", "creatorUrls": [ "https://www.patreon.com/cgpgrey" ], "searchQuery": "true crime podcast", "maxItems": 100 }' | apify call bovi/patreon-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/patreon-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Patreon Scraper – Profiles, Tiers & Posts", "description": "Scrape **Patreon creator profiles**, **membership tiers**, **patron counts**, **earnings estimates**, and **public posts with media** — no login, no API key, no proxy. Four modes: creator, posts, search, post-by-URL. Data from Patreon's own JSON:API, with an SSR fallback for resilience.", "version": "0.1", "x-build-id": "3mpSte67m4fULSZx0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~patreon-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-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/bovi~patreon-scraper/runs": { "post": { "operationId": "runs-sync-bovi-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/bovi~patreon-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-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": { "mode": { "title": "Scrape Mode", "enum": [ "creator", "posts", "search", "postByUrl" ], "type": "string", "description": "What to scrape. 'creator' fetches campaign info + tiers + earnings estimate for one or more Patreon creators. 'posts' fetches the public post list (with media URLs) for a creator's campaign. 'search' finds creators by keyword. 'postByUrl' fetches a single post by its URL or ID.", "default": "creator" }, "creatorUrls": { "title": "Creator URLs", "type": "array", "description": "Patreon creator page URLs or vanity names. Used in 'creator' and 'posts' modes. Accepts full URLs (https://www.patreon.com/cgpgrey) or bare vanity names (cgpgrey). Each item produces one campaign record ('creator' mode) or a batch of post records ('posts' mode).", "items": { "type": "string" } }, "postUrls": { "title": "Post URLs", "type": "array", "description": "Patreon post URLs or numeric post IDs. Used in 'postByUrl' mode only. Example: https://www.patreon.com/posts/some-title-141115192. Each item produces one post record with full media details.", "items": { "type": "string" } }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword to search Patreon for creators. Used in 'search' mode only. Example: 'true crime podcast' returns matching campaign pages ranked by Patreon's own relevance algorithm." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of records to return. In 'creator' mode: max campaigns fetched per vanity/URL. In 'posts' mode: max posts fetched per creator (Patreon paginates 20 at a time). In 'search' mode: max search results returned. Keep low (20–100) for quick agent lookups; raise to 500+ for bulk exports.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional Apify Proxy. Leave OFF — the actor reaches Patreon's JSON:API directly with browser TLS impersonation and needs no proxy for normal runs. Enable Apify Proxy (RESIDENTIAL group) only if you push very high volume and start seeing rate-limit (HTTP 429) warnings; the actor then rotates the exit IP automatically on retry. The buyer's Apify account is billed for any proxy usage.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```