# Cam4 Live Cam Models Scraper (`scrapers_lat/cam4-scraper`) Actor

Scrape Cam4 live broadcasters with viewers, gender, country, tags, thumbnail and direct profile links. Filter by gender. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/cam4-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Social media, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.80 / 1,000 results

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?

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

[![Cam4 Live Cam Models Scraper](https://scrapers.lat/banners/cam4-scraper.png)](https://console.apify.com/actors/Eb0gPMz8E8zOL33O4/input)

## Cam4 Live Cam Models Scraper

Here is one real result, with every field the actor returns:

```json
{
  "id": "56163763",
  "username": "AdamMcclintock",
  "displayName": "AdamMcclintock",
  "gender": "female",
  "broadcastType": "female",
  "sexualOrientation": "straight",
  "country": "gb",
  "realCountry": null,
  "viewers": 109,
  "showType": "PUBLIC_SHOW",
  "verified": null,
  "tags": ["masturbation", "18-plus-girls", "blonde", "twerk", "pee", "fantasy", "fitness"],
  "thumbnail": "https://stackvaults-media.xcdnpro.com/ygLyM844ehGUtKSWLtG0K-8rqTsuhEgKkpwJO8zn-9c//resize:fit:400:300:1/quality:100/...",
  "previewUrl": null,
  "hasBoostBadge": false,
  "hasDailyAwardBadge": false,
  "hasLiveTouchBadge": false,
  "hasNewBroadcasterBadge": true,
  "hasViewerCountBadge": false,
  "url": "https://www.cam4.com/AdamMcclintock",
  "source": "Cam4",
  "observedAt": "2026-08-10T14:28:25.365Z"
}
```

The most complete Cam4 live cam models scraper available. It returns every field the Cam4 live directory exposes for a broadcaster (username, gender and broadcast type, sexual orientation, country, live viewer count, show type, tags, thumbnail, badge flags and a direct profile link), and gives you gender, viewer, country and tag filters to target exactly the broadcasters you need.

**📥 [Input](https://apify.com/scrapers_lat/cam4-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/cam4-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/cam4-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/cam4-scraper/examples)**

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Coverage](https://img.shields.io/badge/Coverage-Cam4%20live%20directory-blue)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)
![Billing](https://img.shields.io/badge/Billing-Pay%20per%20result-brightgreen)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)

### What it does

The actor reads the Cam4 public live directory for the gender you select, parses the server-rendered broadcaster list, applies your filters, sorts by live viewer count, and writes one normalized record per online broadcaster to the run's dataset. Each record carries the username, gender and broadcast type, sexual orientation, country, current viewer count, show type, verification flag, tags, thumbnail, badge flags and a direct profile link.

Only broadcasters currently online are returned. Optional filters (`minViewers`, `country`, `tags`, `verifiedOnly`) narrow the list client-side. This is public listing data only, with no account or key required.

### Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 live female broadcasters, sorted by viewers.

```json
{
  "gender": "female",
  "maxCreators": 10,
  "minViewers": 50
}
```

Every field is optional; `gender` defaults to `female`. Leave the filters empty to return the busiest live broadcasters for the selected gender.

### Input reference

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `gender` | enum | no | `female` | Which live directory to read: `female`, `male`, `couple`, `trans`, `all`. |
| `maxCreators` | integer | no | `10` | Maximum broadcasters to collect (1 to 1000000). Free Apify plans are capped at 10. |
| `minViewers` | integer | no | (none) | Only return broadcasters with at least this many live viewers. |
| `country` | string | no | (empty) | Only return broadcasters whose country contains this text (`US`, `France`, `Colombia`). Case-insensitive. |
| `tags` | string\[] | no | (empty) | Only return broadcasters carrying at least one of these tags. Case-insensitive. |
| `verifiedOnly` | boolean | no | `false` | Only return verified broadcasters. |

Filters combine with logical AND and run client-side on the live list. Results are sorted by live viewer count (highest first) before `maxCreators` is applied.

### Output reference

One dataset item per live broadcaster. Types: `string`, `integer`, `boolean`, `string[]`, or `null` when the value is absent.

| Field | Type | Description |
|---|---|---|
| `id` | string | Cam4 broadcaster id. |
| `username` | string | Broadcaster username. |
| `displayName` | string | Display name (same as username). |
| `gender` | string | Gender/broadcast category. |
| `broadcastType` | string | Broadcast type. |
| `sexualOrientation` | string | Sexual orientation, or `null`. |
| `country` | string | Country code as listed, or `null`. |
| `realCountry` | string | Real country when exposed, or `null`. |
| `viewers` | integer | Current live viewer count, or `null`. |
| `showType` | string | Show type, for example `PUBLIC_SHOW`. |
| `verified` | boolean | Verification flag, or `null`. |
| `tags` | string\[] | Tags on the broadcast, or `null`. |
| `thumbnail` | string | Thumbnail image URL, or `null`. |
| `previewUrl` | string | Preview URL, or `null`. |
| `hasBoostBadge` | boolean | Boost badge flag. |
| `hasDailyAwardBadge` | boolean | Daily award badge flag. |
| `hasLiveTouchBadge` | boolean | Live touch badge flag. |
| `hasNewBroadcasterBadge` | boolean | New broadcaster badge flag. |
| `hasViewerCountBadge` | boolean | Viewer count badge flag. |
| `url` | string | Direct profile URL. |
| `source` | string | Data source label (`Cam4`). |
| `observedAt` | string | ISO 8601 timestamp of when the record was collected. |

### Example output record

Real record from a live run (input `{"gender": "female", "maxCreators": 10}`, thumbnail URL truncated for length):

```json
{
  "id": "56163763",
  "username": "AdamMcclintock",
  "gender": "female",
  "broadcastType": "female",
  "sexualOrientation": "straight",
  "country": "gb",
  "viewers": 109,
  "showType": "PUBLIC_SHOW",
  "tags": ["masturbation", "18-plus-girls", "blonde", "twerk", "pee", "fantasy", "fitness"],
  "thumbnail": "https://stackvaults-media.xcdnpro.com/...",
  "hasNewBroadcasterBadge": true,
  "url": "https://www.cam4.com/AdamMcclintock",
  "source": "Cam4",
  "observedAt": "2026-08-10T14:28:25.365Z"
}
```

### Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace `<TOKEN>` with your Apify API token.

Run synchronously and get dataset items in one call:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~cam4-scraper/run-sync-get-dataset-items?token=%3CTOKEN%3E" \
  -H "Content-Type: application/json" \
  -d '{"gender":"female","maxCreators":25,"minViewers":50}'
```

Start a run asynchronously:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~cam4-scraper/runs?token=%3CTOKEN%3E" \
  -H "Content-Type: application/json" \
  -d '{"gender":"couple","country":"Colombia","maxCreators":100}'
```

Apify CLI:

```bash
apify call scrapers_lat/cam4-scraper \
  --input '{"gender":"trans","tags":["blonde"]}'
```

### Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing `format`:

```bash
## JSON
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=json"

## CSV
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=csv"

## Paginate large datasets
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&offset=1000&limit=1000"
```

`<DATASET_ID>` is returned as `defaultDatasetId` in the run object. Use `offset` and `limit` to page through large result sets. `clean=true` drops empty and internal fields.

### Billing and limits

- **Pay per result.** You are charged per broadcaster returned (`result` event). See the [pricing tab](https://apify.com/scrapers_lat/cam4-scraper/pricing) for the current per-result price.
- **No charge on failure.** If no live broadcasters are returned or the request fails, the actor writes a single item with a populated `error` field and does not charge. Empty runs cost nothing.
- **Spend cap respected.** Set `maxTotalChargeUsd` on the run; once reached, the actor stops emitting and charging further billable results.
- **Free Apify plans** are capped at 10 records per run. Upgrade for higher `maxCreators`.

### FAQ and troubleshooting

**Does it return offline models?**
No. The Cam4 live directory only lists broadcasters who are currently online, so every record is a live broadcast at the time of the run.

**How are results ordered?**
By live viewer count, highest first, before `maxCreators` is applied. Use `minViewers` to drop low-traffic rooms.

**Can I filter by country or tag?**
Yes. Set `country` (matched against the listed and real country) and/or `tags` (a broadcaster passes if it carries at least one). Both are case-insensitive.

**Why is `verified` null for some broadcasters?**
The directory does not always expose a verification flag; it is returned as `null` rather than guessed. Use `verifiedOnly` to keep only broadcasters explicitly flagged verified.

**Is this an official Cam4 tool?**
No. This actor is independent and has no affiliation with Cam4. It reads only publicly available live directory data.

### Related scrapers

- [CamSoda Scraper](https://apify.com/scrapers_lat/camsoda-scraper): Live CamSoda broadcasters with viewers and tags.
- [Chaturbate Scraper](https://apify.com/scrapers_lat/chaturbate-scraper): Live Chaturbate broadcasters.
- [Stripchat Scraper](https://apify.com/scrapers_lat/stripchat-scraper): Live Stripchat broadcasters.
- [BongaCams Scraper](https://apify.com/scrapers_lat/bongacams-scraper): Live BongaCams broadcasters.
- [Fansly Profile Scraper](https://apify.com/scrapers_lat/fansly-profile-scraper): Fansly creator profile data.

### More scrapers at scrapers.lat

Built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at [scrapers.lat](https://scrapers.lat).

***

> Independent tool, not affiliated with Cam4. Accesses only publicly available live directory data. All broadcasters are adults (18+).

# Actor input Schema

## `maxCreators` (type: `integer`):

Maximum number of live cam models (broadcasters) to collect. Optional.

## `gender` (type: `string`):

Which live directory to read.

## `minViewers` (type: `integer`):

Only return broadcasters with at least this many live viewers. Optional.

## `country` (type: `string`):

Only return broadcasters whose country contains this text (for example US, France, Colombia). Case insensitive. Optional.

## `tags` (type: `array`):

Only return broadcasters carrying at least one of these tags. Case insensitive. Optional.

## `verifiedOnly` (type: `boolean`):

Only return verified broadcasters.

## Actor input object example

```json
{
  "maxCreators": 10,
  "gender": "female",
  "tags": [],
  "verifiedOnly": false
}
```

# Actor output Schema

## `results` (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 = {
    "maxCreators": 10,
    "gender": "female",
    "tags": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/cam4-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 = {
    "maxCreators": 10,
    "gender": "female",
    "tags": [],
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/cam4-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 '{
  "maxCreators": 10,
  "gender": "female",
  "tags": []
}' |
apify call scrapers_lat/cam4-scraper --silent --output-dataset

```

## MCP server setup

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