# Patreon Premium Creator & Posts Scraper (`radeance/patreon-scraper`) Actor

Instantly access creator data including earnings estimates, membership tiers, posts, subscriber counts, Graphtreon content metrics, and social media links from Patreon.com. Specify creators by profile URL or scrape at scale. Download your data as JSON, CSV, Excel for market research or AI automation

- **URL**: https://apify.com/radeance/patreon-scraper.md
- **Developed by:** [Radeance](https://apify.com/radeance) (community)
- **Categories:** Social media, Automation, Developer tools
- **Stats:** 281 total users, 1 monthly users, 100.0% runs succeeded, 5 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$24.99/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Premium Creator & Posts Scraper

<img src="https://i.imgur.com/SmtENuj.png" alt="Patreon Scraper Scraper Cover Image" style="border-radius: 15px;" />
<br><br>
<table style="border-collapse: collapse; width: 100%;">
  <tr>
    <th style="border-bottom: 2px solid #333; padding: 12px 16px; text-align: left; font-weight:600;">
      Discover more ➤
    </th>
    <td style="border-bottom: 1px solid #ddd; padding: 12px 16px;">
      <a href="https://apify.com/radeance/tiktok-video-scraper-premium" style="color:#BF7D7D; text-decoration:none; font-weight:600;">
        TikTok Video Scraper
      </a>
    </td>
    <td style="border-bottom: 1px solid #ddd; padding: 12px 16px;">
      <a href="https://apify.com/radeance/socialblade-api" style="color:#BF7D7D; text-decoration:none; font-weight:600;">
        Social Blade Scraper
      </a>
    </td>
    <td style="border-bottom: 1px solid #ddd; padding: 12px 16px;">
      <a href="https://apify.com/radeance/similarweb-scraper" style="color:#BF7D7D; text-decoration:none; font-weight:600;">
        Similarweb Scraper
      </a>
    </td>
    <td style="border-bottom: 1px solid #ddd; padding: 12px 16px;">
      <a href="https://apify.com/radeance/ahrefs-scraper" style="color:#BF7D7D; text-decoration:none; font-weight:600;">
        Ahrefs Scraper
      </a>
    </td>
  </tr>
</table>
<br>

Welcome to the **Premium Patreon Creator Scraper** on **Apify**, your all-in-one solution for collecting in-depth creator and membership data from Patreon with high quality precision.

This scraper extracts **comprehensive creator analytics**, **membership tiers**, **post performance data**, and **earnings estimates** directly from Patreon, enriched with **Graphtreon insights** for more accurate statistics and ranking data.

Built for **scale and reliability**, it can crawl hundreds of creator profiles in minutes, gathering thousands of data points including **patron counts**, **category rankings**, **content mix**, **tier structures**, and **monetization insights** — all in clean, structured formats ready for dashboards, analytics, or business intelligence workflows.

Perfect for **market researchers**, **analysts**, **media strategists**, and **creator economy platforms** looking to understand audience trends, revenue distribution, and creator performance.

### 🗝️ Key Features

- **✅ Comprehensive Creator Profile Scraping:**
  - Scrapes creators by creator name or profile URL (bulk URLs supported)
  - Extracts key creator details: creator ID, name, creation date, category, rankings,description and SEO data
  - Captures profile images, background posters, and branding elements
  - Retrieves social media links (Spotify, YouTube, Instagram, Twitter, TikTok, Facebook, Twitch)

- **✅ Advanced Financial & Performance Analytics:**
  - Membership statistics: total members, paid members, patron counts
  - Revenue insights: estimated monthly earnings (min/max ranges), earnings currency
  - Platform performance: category rankings, overall Patreon rankings
  - Growth metrics and engagement tracking

- **✅ Detailed Membership Tier Analysis:**
  - Complete tier structure with pricing, features, and post availability
  - Tier-specific benefits and exclusive content access levels
  - Member distribution across different subscription levels

- **✅ Content & Engagement Intelligence:**
  - Recent posts data: titles, types (video, podcast, text), publication dates
  - Engagement metrics: likes, comments, commenter counts for each post
  - Post thumbnails and preview URLs
  - Perfect for content categorization and posting frequency analysis

- **✅ Creator Insights & Audience Data:**
  - NSFW content flags and content category classification
  - Free trial availability and monetization strategies
  - Creator descriptions and value propositions

- **✅ High-Speed Performance:**
  - Scrapes hundreds of creator profiles in minutes with parallel processing
  - Smart rate limiting and request optimization for reliable data collection

- **✅ Flexible Output Formats:**
  - Exports results in multiple formats: JSON, CSV, XLSX, JSONL
  - Clean, structured data ready for analytics, business intelligence, or competitive analysis
  - Comprehensive dataset perfect for market research and creator economy insights

### 🖇️ Use Cases

- **Marketing Teams & Agencies:** Analyze creator monetization strategies, identify potential brand partnerships, and benchmark competitor creator programs across industries
- **Business Intelligence & Strategy:** Extract creator economy insights, revenue modeling data, and membership tier optimization strategies for subscription-based businesses
- **Data Scientists & Analysts:** Collect comprehensive Patreon datasets to model creator success factors, subscription trends, and content monetization patterns
- **Content Creators & Coaches:** Research successful creators in your niche, analyze pricing strategies, membership tiers, and content delivery methods
- **Investment & Market Research:** Study the creator economy landscape, evaluate platform growth trends, and assess creator business sustainability for investment decisions

#### How Limits Work

- **Free users**: Limited to 5 runs with up to 3 creators per run in a 24-hour period from your first usage
- **Paid users**: No limits on the number of runs, unlimited creators per run

### 📍 Output

```json
{
  "creator_id": "2211846",
  "created_at": "2018-11-12T03:50:54Z",
  "published_at": "2018-11-15T10:23:39Z",
  "profile_url": "https://www.patreon.com/coldones",
  "profile_image_url": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/2211846/0209ba0e8b3348419510732176710c8f/eyJxIjoxMDAsIndlYnAiOjB9/10.png?token-hash=LsLOA4r4x-zKAvvibkZkhH0pNz52p-TgmxhBMGa6tTg%3D&token-time=1773792000",
  "creator_name": "Cold Ones",
  "about": null,
  "description": "Join for extended and uncensored videos, the exclusive Sober Podcast, bonus gaming content, behind-the-scenes chaos and all the extra shenanigans from Max, Chad and the entire Cold Ones crew! Your support helps us create more content, pay our crew, and of course, buy more grog.",
  "category": "Video",
  "category_rank": 6,
  "category_rank_daily": [
    {
      "date": "2018-12-11T01:00:00",
      "value": 1370
    },
    {
      "date": "2018-12-12T01:00:00",
      "value": 1379
    },
    {
      "date": "2018-12-13T01:00:00",
      "value": 1326
    },
    ...
    {
      "date": "2026-02-28T01:00:00",
      "value": 6
    },
    {
      "date": "2026-03-01T01:00:00",
      "value": 6
    },
    {
      "date": "2026-03-02T01:00:00",
      "value": 6
    }
  ],
  "patreon_rank": 20,
  "total_creations": 464,
  "total_posts": 464,
  "posts_mix": {
    "audio": 0,
    "video": 337,
    "poll": 0,
    "image": 11,
    "link": 2,
    "livestream": 0,
    "podcast": 104
  },
  "total_members": 102951,
  "paid_members": 23697,
  "paid_members_daily": [
    {
      "date": "2018-12-11T01:00:00",
      "value": 207
    },
    {
      "date": "2018-12-12T01:00:00",
      "value": 214
    },
    {
      "date": "2018-12-13T01:00:00",
      "value": 224
    },
    ...
    {
      "date": "2026-02-28T01:00:00",
      "value": 23827
    },
    {
      "date": "2026-03-01T01:00:00",
      "value": 23609
    },
    {
      "date": "2026-03-02T01:00:00",
      "value": 23649
    }
  ],
  "paid_members_monthly": [
    {
      "date": "2018-12-01T01:00:00",
      "value": 210
    },
    {
      "date": "2019-01-01T01:00:00",
      "value": 453
    },
    {
      "date": "2019-02-01T01:00:00",
      "value": 441
    },
    ...
    {
      "date": "2025-12-01T01:00:00",
      "value": 22186
    },
    {
      "date": "2026-01-01T01:00:00",
      "value": 23282
    },
    {
      "date": "2026-02-01T01:00:00",
      "value": 23609
    }
  ],
  "pledge_sum": 8546751.0,
  "monthly_earnings": null,
  "earnings_currency": "USD",
  "earnings_per_month": 100136.0,
  "earnings_per_patron": 4.23,
  "earnings_per_patron_daily": [
    {
      "date": "2018-12-11T01:00:00",
      "value": 5.37
    },
    {
      "date": "2018-12-12T01:00:00",
      "value": 5.34
    },
    {
      "date": "2018-12-13T01:00:00",
      "value": 5.34
    },
    ...
    {
      "date": "2025-12-01T01:00:00",
      "value": 4.25
    },
    {
      "date": "2026-01-01T01:00:00",
      "value": 4.2
    },
    {
      "date": "2026-02-01T01:00:00",
      "value": 4.23
    }
  ],
  "earnings_daily": [
    {
      "date": "2018-12-11T01:00:00",
      "value": 1110.6
    },
    {
      "date": "2018-12-12T01:00:00",
      "value": 1142.1
    },
    {
      "date": "2018-12-13T01:00:00",
      "value": 1196.1
    },
    ...
    {
      "date": "2026-02-28T01:00:00",
      "value": 100391
    },
    {
      "date": "2026-03-01T01:00:00",
      "value": 99906.9
    },
    {
      "date": "2026-03-02T01:00:00",
      "value": 100136
    }
  ],
  "earnings_monthly": [
    {
      "date": "2018-12-01T01:00:00",
      "value": 1077.94
    },
    {
      "date": "2019-01-01T01:00:00",
      "value": 2519.26
    },
    {
      "date": "2019-02-01T01:00:00",
      "value": 2365.09
    },
    ...
    {
      "date": "2025-12-01T01:00:00",
      "value": 94333
    },
    {
      "date": "2026-01-01T01:00:00",
      "value": 97836.5
    },
    {
      "date": "2026-02-01T01:00:00",
      "value": 99906.9
    }
  ],
  "estimated_monthly_earnings_formatted": null,
  "min_estimate_monthly_earnings": null,
  "max_estimate_monthly_earnings": null,
  "declined_patron_count": 24427,
  "offers_free_membership": true,
  "offers_paid_membership": true,
  "has_visible_shop": false,
  "shows_earnings": true,
  "shows_patron_count": true,
  "shows_free_trial": true,
  "is_nsfw": false,
  "is_hot_creator": true,
  "hot_creator_month": "Aug 2021",
  "campaign_id": "2211846",
  "tiers": [
    {
      "id": "10303137",
      "title": "Free",
      "price": null,
      "currency": "USD",
      "declined_patron_count": 254,
      "available_posts": 1,
      "features": []
    },
    {
      "id": "3124638",
      "title": "🍺 Buy us a Drink 🥃",
      "price": 5.0,
      "currency": "USD",
      "declined_patron_count": 24173,
      "available_posts": 17,
      "features": []
    }
  ],
  "posts": [
    {
      "id": "151437621",
      "created_at": "2026-02-23T06:36:49Z",
      "published_at": "2026-02-25T02:25:12Z",
      "post_type": "video_external_file",
      "is_paid": true,
      "title": "👨🏻‍🦲 Sober #EP 100 - BALD",
      "comments": 318,
      "commenter_count": 181,
      "likes": 228,
      "description": null,
      "duration": 4455.918133,
      "duration_formatted": "01:14:15",
      "post_url": "https://www.patreon.com/posts/sober-ep-100-151437621",
      "pledge_url": "https://www.patreon.com/checkout/coldones",
      "thumbnail_url": "https://c10.patreonusercontent.com/4/patreon-media/p/post/151437621/ece14eaeb64f4fb694fdfd7025b038c4/eyJ3IjoxMDgwfQ%3D%3D/1.png?token-hash=t3UzmCXDuyN0xVFx0SKhH8iPuogD0v2sXk78wXmwmw4%3D&token-time=1773792000",
      "thumbnail_square_url": "https://c10.patreonusercontent.com/4/patreon-media/p/post/151437621/ece14eaeb64f4fb694fdfd7025b038c4/eyJoIjoxMDgwLCJ3IjoxMDgwfQ%3D%3D/1.png?token-hash=VvsDnP0DXYDQEwIOChWxMxM9IcZniEFOsz-2wlbKVd8%3D&token-time=1773792000",
      "preview_url": "https://stream.mux.com/01tvA01go2NZUPYn02zmpOkNNuh00RHNpf8JBwa024hKeHFI.m3u8?token=eyJhbGciOiJSUzI1NiIsImtpZCI6Ik5CY3o3Sk5RcUNmdDdWcmo5MWhra2lEY3Vyc2xtRGNmSU1oSFUzallZMDI0IiwidHlwIjoiSldUIn0.eyJzdWIiOiIwMXR2QTAxZ28yTlpVUFluMDJ6bXBPa05OdWgwMFJITnBmOEpCd2EwMjRoS2VIRkkiLCJleHAiOjE3NzI2MzY0MDAsImF1ZCI6InYifQ.IunHSsyLelfMUsu-RgP_8fYaVLSPdMc54bXVl22aZsRHNkg-qH5VckjkVU0O2PyEqRqnmIYMjI9vRGF_d8aW3gD6uww_NeF4H_Vb6mFsQNyczYo3W9aH4k4dU5zv4jeS4McB19cQYUq6VK9hGlJD93AwNHXhIaVKQB48NI8zEwP-neArKOMm0gRwNUDRUonKUT2TlRlq4hBtT3mLSwMnxOff2iKbi-GgwSMuhitTkt2BxzQqmFqhAX6ICM9hcHgQkaFpKJZegW87VEWM_7uEr31VtGTx5k6NXFvNnkyC3qOE9AvEePDmeqHLQd_R1IwI3Uk8nHhmuTYy_qCB3CvOww",
      "preview_duration": 30.0,
      "api_url": null
    },
    {
      "id": "151596258",
      "created_at": "2026-02-25T02:20:19Z",
      "published_at": "2026-02-25T02:25:03Z",
      "post_type": "podcast",
      "is_paid": true,
      "title": "👨🏻‍🦲 Sober #EP 100 - BALD (AUDIO) ",
      "comments": 5,
      "commenter_count": 4,
      "likes": 15,
      "description": null,
      "duration": 300.0,
      "duration_formatted": null,
      "post_url": "https://www.patreon.com/posts/sober-ep-100-151596258",
      "pledge_url": "https://www.patreon.com/checkout/coldones",
      "thumbnail_url": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/2211846/0209ba0e8b3348419510732176710c8f/eyJ3Ijo2MjB9/10.png?token-hash=VgpZo-7be5qA0kKeIBGbaytFGO0NbLz4if6WwyBF9qI%3D",
      "thumbnail_square_url": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/2211846/8825ccfa351941d89926895cac7a0ccb/eyJoIjoxMDgwLCJ3IjoxMDgwfQ%3D%3D/1.png?token-hash=4ABLCEw9WrIDkIjMF82UKDaR4VskLsUoL1kyDVzZLOY%3D&token-time=1773792000",
      "preview_url": "https://c10.patreonusercontent.com/4/patreon-media/p/media/619522213/c24705a2ffc34f19b904f79a68fe1920/eyJhIjoxLCJpc19hdWRpbyI6MSwicCI6MX0%3D/1.mp3?token-hash=ufM4d29-q_GKnJNCyAmtEg2ZQ_WPQBKpLvCBIeiYfWc%3D&token-time=1772668800",
      "preview_duration": 300.0,
      "api_url": "https://www.patreon.com/api/media/619522381"
    },
    ...
    {
      "id": "147418034",
      "created_at": "2026-01-04T22:13:34Z",
      "published_at": "2026-01-04T23:38:01Z",
      "post_type": "video_external_file",
      "is_paid": true,
      "title": "Best of Cold Ones Patreon 2025",
      "comments": 213,
      "commenter_count": 92,
      "likes": 346,
      "description": null,
      "duration": 3413.343267,
      "duration_formatted": "00:56:53",
      "post_url": "https://www.patreon.com/posts/best-of-cold-147418034",
      "pledge_url": "https://www.patreon.com/checkout/coldones",
      "thumbnail_url": "https://c10.patreonusercontent.com/4/patreon-media/p/post/147418034/b2c7fca732c54445b9c69d697ad5ca7d/eyJiIjo4LCJ3IjoxMDgwfQ%3D%3D/1.png?token-hash=xyrDynwHsXelFJeo_gcWl2eaegv9rLA3HfVWqytxxzs%3D&token-time=1773792000",
      "thumbnail_square_url": "https://c10.patreonusercontent.com/4/patreon-media/p/post/147418034/b2c7fca732c54445b9c69d697ad5ca7d/eyJiIjo4LCJoIjoxMDgwLCJ3IjoxMDgwfQ%3D%3D/1.png?token-hash=jaeSsaJa9rHU-RCjWzuzsyWEPyCLxgQvbbpNj7f_-8Y%3D&token-time=1773792000",
      "preview_url": "https://stream.mux.com/CNnSio02WH5rgnR7XVgibfkB3uykvLYXNd001CiGbrPzc.m3u8?token=eyJhbGciOiJSUzI1NiIsImtpZCI6Ik5CY3o3Sk5RcUNmdDdWcmo5MWhra2lEY3Vyc2xtRGNmSU1oSFUzallZMDI0IiwidHlwIjoiSldUIn0.eyJzdWIiOiJDTm5TaW8wMldINXJnblI3WFZnaWJma0IzdXlrdkxZWE5kMDAxQ2lHYnJQemMiLCJleHAiOjE3NzI2MzY0MDAsImF1ZCI6InYifQ.modEhQ77R4VOftgD9oZ_0dqEFWa_DoeGsZBqzJrttKGxiwRGy3u0W6YzUkldT4DgqNOZdFmw7U2woCTeCdGjZaaHRkgiOaI20FF22pF-MTSAaQHoHw2FfkfjJrNGllAY_u1vESs4aX3cZZiZ99EL_inxTlkaL45jfX5qRCaXgcq28M6LJ4ycs-ODDMYOtXUdeG4Xx80KzAMo9Qup0mFwNwJAabZl9q2615lC-460p86QJzhD288js1uspPApZRtRhT7ws_iqtjjLcEJNVIycCREyV68kzYgiajFh4HwKFSY52kJSvvp7ngFlSxB6_qRJ8kcx--3OpNUHL3QFE13MWQ",
      "preview_duration": 30.0,
      "api_url": null
    }
  ],
  "thumbnail_url": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/2211846/0209ba0e8b3348419510732176710c8f/eyJoIjozNjAsInciOjM2MH0%3D/10.png?token-hash=6OkSoU8WI7S0lLNb_S8u8lzAkWcZQZVrjyJnIgCWC6w%3D&token-time=1773792000",
  "background_poster_url": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/2211846/a3b2badc91a142c497be97f078608540/eyJ3IjoxNjAwLCJ3ZSI6MX0%3D/7.jpeg?token-hash=17WbtEXSewhr6rRUJU0rEllYV_j8NuU7PFPJ4SrRZYQ%3D&token-time=1775260800",
  "primary_theme_color": "#000000",
  "spotify": "https://open.spotify.com/show/00b1jriv1TuJBgvMktpctc",
  "youtube": "https://youtube.com/channel/UCfbnTUxUech4P1XgYUwYuKA",
  "instagram": null,
  "twitter": null,
  "facebook": null,
  "twitch": null,
  "tiktok": null,
  "graphtreon_url": "https://www.graphtreon.com/creator/coldones"
}
```

### 📌 Input

<img src="https://i.imgur.com/3kMiHcK.png" alt="Patreon Scraper Scraper Basic Input Image" style="border-radius: 15px;" />

**- `creator`**: **(Required) (String)**
Enter the Patreon creator's username to scrape their profile data. This will be used to search for the creator's page if no direct URLs are provided in the bulk URL section.

**- `include_posts`**: **(Optional) (Boolean) (Default: true)**
Enable to include detailed posts data from the creator's Patreon page when available. This includes post titles, engagement metrics, content types, and publication dates.

**- `include_graphtreon`**: **(Optional) (Boolean) (Default: true)**
Enable to enhance results with additional analytics data from Graphtreon.com when available. This provides supplementary insights and historical data on earnings and members for deeper creator analysis.

**- `max_posts`**: **(Optional) (Integer) (Default: 20)**
Set the maximum number of recent posts to scrape per creator. Range: 1-10,000 posts. Set to higher values for comprehensive content analysis or lower values for faster processing.

**- `creator_urls`**: **(Optional) (Array) (Default: empty)**
Enter Patreon creators by their handle or by creator page url to scrape in bulk. You can specify multiple items by clicking on the Add button or in bulk by clicking on the Bulk edit button. If provided, this will override the single creator parameter above.

**- `stream_output`**: **(Optional) (Array) (Default: empty)**
If checked, the actor will stream the data while processing the query.. This is useful for real-time monitoring of the scraping process. If unchecked, the actor will only save the output to the dataset at the end of the scraping process.

<br>
<br>

#### Supported Creator Slug & URL Formats

| Format                                                                                   | Supported |
| ---------------------------------------------------------------------------------------- | --------- |
| TheBasementYard                                                                          | ✅        |
| <https://www.patreon.com/TheBasementYard>       | ✅        |
| <https://www.patreon.com/cw/TheBasementYard> | ✅        |

|

#### ✏️ JSON Input

Sample JSON input if you use the apify api via CURL, Python, JS etc.

```
{
  "creator": "TheBasementYard",
  "include_graphtreon": true,
  "include_posts": true,
  "max_posts": 20
}
```

### 🍪 Usage Limits

This service has different usage limits depending on your subscription status:

| User Type | Daily Runs | Max Creators per Run | Reset Period |
| --------- | ---------- | -------------------- | ------------ |
| **Free**  | 5 runs     | 3 per run            | 24-hours     |
| **Paid**  | Unlimited  | Unlimited            | N/A          |

### 🗒️ Detailed Output Information

#### Creator Profile Data

Includes comprehensive metadata for each Patreon creator, such as:

- `creator_id` - Unique Patreon creator identifier
- `creator_name` - Display name of the creator
- `created_at` - Account creation timestamp
- `profile_url` - Direct link to the creator's Patreon page
- `profile_image_url` - Creator's profile picture URL
- `description` - Creator's bio and value proposition text
- `category` - Content category (e.g., "Podcasts", "Art", "Gaming") (via Graphetreon)
- `is_nsfw` - Boolean flag indicating adult content

#### Performance & Analytics

Provides detailed performance metrics and rankings:

- `total_members` - Total number of patrons/subscribers
- `paid_members` - Number of paying subscribers
- `category_rank` - Ranking within their content category (via Graphetreon)
- `patreon_rank` - Overall platform ranking (via Graphetreon)
- `monthly_earnings` - Monthly earnings (via Patreon if visible)
- `estimated_avg_monthly_earnings` - Average estimated monthly revenue (via Graphtreon)
- `min_estimate_monthly_earnings` - Minimum estimated earnings range (via Graphtreon)
- `max_estimate_monthly_earnings` - Maximum estimated earnings range (via Graphtreon)
- `earnings_currency` - Currency for earnings (typically USD)

#### Membership Tier Structure

Comprehensive breakdown of subscription offerings:

- `tiers` - Array of all membership tiers with detailed information
- `id` - Unique tier identifier
- `title` - Tier name/title
- `price` - Monthly subscription cost
- `currency` - Pricing currency
- `available_posts` - Number of posts accessible at this tier
- `features` - Array of tier-specific benefits and perks

#### Content & Engagement Data

Recent posts and engagement metrics:

- `total_posts` - Total number of posts published
- `posts` - Array of recent posts with detailed metadata
- `post_type` - Content type (video\_embed, podcast, text, etc.)
- `title` - Post title
- `comments` - Number of comments on the post
- `commenter_count` - Unique number of commenters
- `likes` - Post like count
- `published_at` - Post publication timestamp
- `post_url` - Direct link to the post

#### Social Media & Branding

Creator's external presence and visual branding:

- `spotify` - Spotify podcast URL
- `youtube` - YouTube channel URL
- `instagram` - Instagram profile URL
- `twitter` - Twitter/X profile URL
- `tiktok` - TikTok profile URL
- `facebook` - Facebook page URL
- `twitch` - Twitch channel URL
- `thumbnail_url` - Main profile thumbnail image
- `background_poster_url` - Background/banner image URL
- `primary_theme_color` - Brand color in hex format

#### Platform Features

Patreon-specific functionality indicators:

- `shows_earnings` - Whether earnings are publicly displayed
- `shows_patron_count` - Whether patron count is visible
- `shows_free_trial` - Whether free trials are offered
- `seo_description` - SEO meta description
- `seo_keywords` - SEO keywords for discoverability

#### Export Formats

- Data can be exported in CSV, XLSX, JSON, JSONL, XML, and RSS formats for seamless integration into your data pipeline or analytics workflow.

### ⚙️ While the scraper is running

During the run, the actor will output log messages letting you know what is going on at any point. Each message always contains specific information about the process including which url / page the actor is working on.

If you provide invalid inputs to the actor, it will immediately stop with a failure state and output log messages explaining what is wrong. If you are unsure what went wrong feel free to open up an issue in the issue tab.

### 🔗 Legality of web scraping

The **Patreon Premium Creator & Posts Scraper** is designed to ethically extract **only publicly available data**, and it **does not** scrape private user data such as personal email addresses or personal identifiers.

Our scrapers are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our scrapers, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read our [blog post](https://blog.apify.com/is-web-scraping-legal/) on the legality of web scraping

### 💬 Feedback and Support

**Your satisfaction** is **important** to us! Therefore we are constantly striving to enhance the performance of our services.

If you have any technical feedback or encounter any bugs within the **Patreon Premium Creator & Posts Scraper**, please create an issue in the Actor’s Issues tab on the Apify Console to let us know about it. We will look into it as soon as possible.

You can also contact us directly for help on integrations, customized projects or new use cases at business@radeance.com.

# Actor input Schema

## `creator` (type: `string`):

The username of the creator as it appears in the URL of their Patreon page. For example, for https://www.patreon.com/TheBasementYard, the creator is 'TheBasementYard' or the full URL.

## `include_posts` (type: `boolean`):

Whether to include posts data of the creator(s) if available.

## `include_graphtreon` (type: `boolean`):

Whether to include data from Graphtreon.com, if available for the creator. This includes historical earnings, patron members over time, and other stats that Graphtreon provides. Note that this data is only available for creators who have a public profile on Graphtreon and may not be available for all creators.

## `max_posts` (type: `integer`):

The maximum number of posts to scrape per creator. Set to 0 for no limit.

## `creator_urls` (type: `array`):

List of creator handles or / and creator page URLs to scrape from. If left empty, the scraper will use the creator parameter to search for the page.

## `stream_output` (type: `boolean`):

If checked, the actor will stream the data while processing the query.. This is useful for real-time monitoring of the scraping process. If unchecked, the actor will only save the output to the dataset at the end of the scraping process.

## Actor input object example

```json
{
  "creator": "TheBasementYard",
  "include_posts": true,
  "include_graphtreon": true,
  "max_posts": 20,
  "stream_output": true
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "creator": "TheBasementYard",
    "include_posts": true,
    "include_graphtreon": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("radeance/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "creator": "TheBasementYard",
    "include_posts": True,
    "include_graphtreon": True,
}

# Run the Actor and wait for it to finish
run = client.actor("radeance/patreon-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "creator": "TheBasementYard",
  "include_posts": true,
  "include_graphtreon": true
}' |
apify call radeance/patreon-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,radeance/patreon-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/B6cyzsNeJoBlbCbSz/builds/MXT7Te1sw92ZV5Sio/openapi.json
