# Fanvue Scraper 🔥 (`deepmine/fanvue-scraper`) Actor

Search Fanvue creators by keyword (niche, look, city) or paste usernames. Get each creator's price, promos and free trials, bundles, likes, subscribers, posts, photos and videos, AI-creator flag, bio and profile link. For AI OFM agencies, talent scouts and creator research.

- **URL**: https://apify.com/deepmine/fanvue-scraper.md
- **Developed by:** [DeepMine](https://apify.com/deepmine) (community)
- **Categories:** Social media, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 272 total users, 13 monthly users, 98.6% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 creator profiles

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Fanvue Scraper 🔥 Creator Search & Profile Data

Type a keyword like `fitness`, `cosplay` or `Miami`, or paste Fanvue usernames, and get each Fanvue creator's price, promos, likes, subscribers and post counts in one table. No Fanvue account, login or cookies needed.

| Username | Price | Promo | Likes | Subs | Posts | AI | Keywords |
|---|---|---|---|---|---|---|---|
| maeveeeee | $9.98 | 1-day free trial | 220,972 | 170 | 214 | yes | miami |
| ameliastanley | $9.99 | 50% off | 89,277 | 16 | 209 | yes | fitness, miami |
| alessandraliu\_ | $12.99 | 55% off | 59,180 | 1,633 | 543 | no | miami |

<sub>Collected 2026-09-28. Counts and promos change over time.</sub>

**$5.00 per 1,000 creators** on the Starter plan ($6.00 Free, $4.50 Scale, $4.00 Business). The prefilled run (100 creators: `fitness` and `miami`, 50 each) costs about $0.50.

Search several niches in one run. A creator who matches more than one keyword comes back once, with every keyword it matched. Keep only AI creators or only real ones, or set a minimum number of likes. Already have a list? Paste usernames or profile links and get the same row for each.

AI OFM agencies use it to find and benchmark AI models by niche. Talent scouts use it to build creator shortlists. Analysts use it to track Fanvue prices and promos over time.

> **Unofficial product:** This Actor is independently developed and is not affiliated with, endorsed by, or sponsored by Fanvue.

### What you get 💡

- Keyword search across Fanvue creators' names, usernames, bios and locations, most liked first
- Price, running promo (free trial or discount), promo price and end date, multi-month bundles
- Likes, subscribers, posts, photos and videos
- AI-creator and verified flags, free-follow, gender, location, full bio
- Username lookups: handles, `@handles` or `fanvue.com/...` links, returned first and in your order
- Three table views: Overview, Stats, and Pricing & Promos

### How the search works 🔍

Fanvue's own creator search only works when you're logged in to Fanvue, and this Actor never logs in. Instead it searches its own index of **34,560 public Fanvue creators** (built from public pages, refreshed 2026-09-28), then reads every result live from Fanvue's public profile pages. So the prices, promos and counts in your rows are current, not copied from the index.

A creator who joined Fanvue after the last refresh can't be found by keyword yet. Paste their username instead: usernames always work. We rebuild the index about once a month, and the date above shows the latest rebuild.

### Input ⚙️

- `keywords`: words to find in a creator's name, username, bio or location. Every word of a keyword must match (`fitness model` finds creators with both words). Word starts count: `goth` also finds `gothic`.
- `maxResultsPerKeyword`: creators per keyword, most liked first (default 100, up to 10,000).
- `creatorType`: AI and real creators, AI creators only, or real creators only.
- `minLikes`: skip creators with fewer total likes.
- `usernames`: Fanvue usernames or profile links. Filters don't apply to them.
- Advanced: `outputFormat` (`v1` returns version 1.x rows, see below) and `proxyConfiguration` (not needed).

### Output 📦

One row per creator. Rows for your usernames come first, then keyword results, most liked first. A run summary (matches per keyword, usernames not found or not public) is saved as the `OUTPUT` record.

#### Output fields

- `avatar`: profile picture link
- `name`: display name
- `bioSnippet`: first 50 characters of the bio
- `bio`: the full bio
- `username`: Fanvue username
- `profileUrl`: link to the profile on fanvue.com
- `price`: monthly price as Fanvue shows it (`$9.99`, or `Free`)
- `priceUsd`: the price as a number, for sorting and filters
- `promo`: the running promotion (`7-day free trial`, `50% off`), or empty
- `promoPrice`: price during the promotion (`Free` for a free trial)
- `promoEndsAt`: when the promotion ends (UTC), when it has an end date
- `bundles`: multi-month bundles, like `3 months: $26.95 (10% off)`
- `likes`: total likes
- `subscribers`: subscriber count Fanvue shows on the profile
- `posts`: number of posts
- `photos`: number of photos
- `videos`: number of videos
- `isAiCreator`: Fanvue marks the creator as AI
- `isVerified`: has Fanvue's verified badge
- `hasFreeFollow`: fans can follow for free before subscribing
- `gender`: gender the creator lists
- `location`: location the creator lists
- `keywords`: your keywords this creator matched (empty for usernames you looked up)
- `id`: Fanvue's creator id
- `scrapedAt`: when the row was read (UTC)

Views: **📊 Overview** (photo, username, name, bio, link, price, promo, likes, subs, posts, AI, keywords), **📈 Stats** (every number), **💰 Pricing & Promos** (price, promo, promo price, end date, bundles, free follow).

### Version 2.0 (September 2026) 🆕

- New: keyword search, filters, subscribers, posts, photos and videos.
- Price: from $20 to $5 per 1,000 creators on Starter.
- Rows have new, shorter field names (`username` instead of `handle`, `likes` instead of `totalLikes`, `price` + `priceUsd` instead of `subscriptionDisplayPrice` + `subscriptionPrice`, `promo` instead of the separate promo flags).
- **Built an integration on version 1.x?** Add `"outputFormat": "v1"` to your input and you get exactly the rows 1.x returned, same fields and names. That includes 1.x's handling of banned, suspended and hidden profiles: in `v1` they are still returned as rows and charged, as before.
- In the standard output, banned, suspended and hidden profiles are no longer returned as rows and not charged. They are listed in the `OUTPUT` record.
- Memory: username lookups still run with 128 MB, like 1.x. Keyword search needs 256 MB (the default); a keyword run started with less stops right away with a message saying so.

### Pricing and spending limit 💵

You pay per creator delivered: $5.00 per 1,000 on Starter, $6.00 on Free, $4.50 on Scale, $4.00 on Business. There's no start fee. Usernames that don't exist are never charged, and neither are banned or hidden profiles in the standard output (the legacy `v1` output returns and charges them, as 1.x did). If you set a maximum cost for the run, the Actor stops when it's reached and says so in the run's status.

### FAQ ❓

**Do I need a Fanvue account or cookies?**
No. The Actor never logs in.

**Does the keyword search cover every Fanvue creator?**
It covers the 34,560 creators in the index (2026-09-28). New creators join every day; paste a username to get anyone, indexed or not.

**Can I track the same creators over time?**
Yes. Put their usernames in the input and schedule the run daily or weekly to follow price and promo changes.

**Can I get only AI models?**
Yes: set Creator type to "AI creators only". About 70% of the indexed creators are AI.

**What if a username doesn't exist?**
It's skipped, not charged, and listed in the run summary.

### Feedback 💬

Found a problem, or need a field we don't have? Open an issue on the Issues tab; we answer within 48 hours. If the data helped you, a quick review on the Store page helps other people find it.

# Actor input Schema

## `keywords` (type: `array`):

Find Fanvue creators whose name, username, bio or location contains these words ("fitness", "gamer girl", "Miami"). One search per keyword; a creator who matches several comes back once, with every keyword it matched.

## `maxResultsPerKeyword` (type: `integer`):

Most liked creators first. You pay per creator delivered.

## `creatorType` (type: `string`):

Keep only AI creators, only real (non-AI) creators, or both. Applies to keyword results.

## `minLikes` (type: `integer`):

Skip creators with fewer total likes. Applies to keyword results.

## `usernames` (type: `array`):

Already know who you want? Fanvue usernames or profile links (fanvue.com/name), one per line. Returned first, in your order. You can use this with or without keywords.

## `outputFormat` (type: `string`):

"v1" returns the rows version 1.x returned (same fields, same names), for integrations built before version 2.0. New users: keep Standard.

## `proxyConfiguration` (type: `object`):

Not needed: the Actor reads Fanvue directly and switches to Apify Proxy by itself if Fanvue stops answering. Set a proxy here only to force one.

## Actor input object example

```json
{
  "keywords": [
    "fitness",
    "miami"
  ],
  "maxResultsPerKeyword": 50,
  "creatorType": "any",
  "minLikes": 0,
  "outputFormat": "standard"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 = {
    "keywords": [
        "fitness",
        "miami"
    ],
    "maxResultsPerKeyword": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("deepmine/fanvue-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 = {
    "keywords": [
        "fitness",
        "miami",
    ],
    "maxResultsPerKeyword": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("deepmine/fanvue-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 '{
  "keywords": [
    "fitness",
    "miami"
  ],
  "maxResultsPerKeyword": 50
}' |
apify call deepmine/fanvue-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepmine/fanvue-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/Dhl72kJFGorRTVVqq/builds/D580BQijtAzd7QCKy/openapi.json