# Snapchat Profile Scraper (`neuro-scraper/snapchat-profile-scraper`)

Snapchat Profile Scraper. Get all the snapchat public profile data as you need   —  Fast ⚡ | Accurate 🎯 | Automated 🤖

- **URL**: https://beta-securitybyobscurity.apify.com/neuro-scraper/snapchat-profile-scraper.md
- **Developed by:** [Neuro Scraper](https://beta-securitybyobscurity.apify.com/neuro-scraper) (community)
- **Categories:** Automation, Social media, Other
- **Stats:** 10 total users, 9 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00/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/platform/actors/running/actors-in-store#rental-actors

# README

## 🎯 Snapchat Profile Scraper Actor

Powerful Snapchat profile metadata extractor for public profiles.

### 📖 Overview

Scrape Snapchat profile information including username, followers, account type, videos, and related accounts—all in a clean JSON format.

### 💡 Use Cases / When to Use

- Gather analytics for Snapchat influencers.
- Monitor public profiles for engagement metrics.
- Collect video links and account information for automation or research.

### ⚡ Quick Start (Console)

1. Go to the actor page on Apify Console.
2. Click **Run**.
3. Enter your Snapchat profile URLs in the **startUrls** input (JSON array of URLs).
4. Optional: Enable **Apify Proxy** in the Proxy panel.
5. Click **Start**.

### ⚡ Quick Start (CLI + API)

#### CLI

```bash
## Run actor with input JSON
apify run --actor-id <ACTOR_ID> -p input.json
```

#### apify-client (Python)

```python
from apify_client import ApifyClient

client = ApifyClient('<APIFY_TOKEN>')

run_input = {
    "startUrls": ["https://www.snapchat.com/add/exampleuser"],
    "proxyConfiguration": {"useApifyProxy": True}
}

run = client.actor('your-username/snapchat-profile-scraper').call(run_input=run_input)
print(run['defaultDatasetId'])
```

### 📝 Inputs

```json
{
  "startUrls": ["https://www.snapchat.com/add/exampleuser"],
  "proxyConfiguration": {"useApifyProxy": true}
}
```

- **startUrls**: Array of Snapchat profile URLs to scrape.
- **proxyConfiguration**: Proxy settings object (optional, see 🌍 Proxy Configuration).

### ⚙️ Configuration

| 🔑 Name            | 📝 Type     | ❓ Required | ⚙️ Default     | 📌 Example                                                                                | 📝 Notes                                |
| ------------------ | ----------- | ---------- | -------------- | ----------------------------------------------------------------------------------------- | --------------------------------------- |
| startUrls          | array       | ✅ Yes      | null           | \["<https://www.snapchat.com/add/exampleuser>"] | List of Snapchat profile URLs           |
| proxyConfiguration | object      | ❌ No       | {}             | {"useApifyProxy": true}                                                                   | Configure Apify Proxy or custom proxies |
| ALL\_RESULTS       | dataset key | ❌ No       | defaultDataset | null                                                                                      | Default dataset key for outputs         |

*Console example:* paste URLs into **startUrls** field or set an environment variable `APIFY_TOKEN=<YOUR_TOKEN>`.

### 📤 Outputs

Each output item includes:

```json
{
  "name": "Example User",
  "user_name": "exampleuser",
  "followers": "1200",
  "display_picture": "https://profile.pic/url.webp",
  "account_type": "Public",
  "last_updated": "2025-09-15",
  "video_url": "https://www.snapchat.com/spotlight/video123",
  "view_count": "10000",
  "share_count": "500",
  "comment_count": "150",
  "related_link": "Related Topic",
  "related_account": "related_user"
}
```

- Stored in default dataset (`ALL_RESULTS`).

### 🔑 Environment Variables

| Variable     | Description          |
| ------------ | -------------------- |
| APIFY\_TOKEN | Your Apify API token |

### ▶️ How to Run

#### Console

1. Paste URLs into **startUrls**.
2. Optionally configure proxy.
3. Click **Start**.

#### CLI

```bash
apify run --actor-id <ACTOR_ID> -p input.json
```

#### apify-client

See Quick Start above.

### ⏰ Scheduling & Webhooks

- Use **Scheduling** tab in Console to run periodically.
- Webhooks can be added in Console to get notified on actor completion.

### 🐞 Logs & Troubleshooting

- ❌ "No Snapchat profile URLs provided" → Check **startUrls** input.
- ⚠️ Proxy errors → Ensure valid proxy configuration or enable Apify Proxy.

### 🔒 Permissions & Storage notes

- Data is stored in default dataset (`ALL_RESULTS`).
- Proxy credentials should be saved as secrets.

### 🆕 Changelog / Versioning tip

- Keep actor versions tagged in Console for reproducibility.

### 🌍 Proxy Configuration

- **Enable Apify Proxy** in the **Proxy** panel.
- **Custom Proxies**: Set `HTTP_PROXY` and `HTTPS_PROXY` env vars or via **proxyConfiguration** input.

```json
{
  "startUrls": ["https://www.snapchat.com/add/exampleuser"],
  "proxyConfiguration": {
    "useApifyProxy": false,
    "apifyProxyGroups": ["GROUP"],
    "proxyUrls": ["http://<USER>:<PASS>@proxy.com:8000"]
  }
}
```

- 🔒 Keep credentials as secrets.
- TODO: Advanced proxy rotation patterns (for large-scale scraping).

### 📌 Notes / TODOs

- TODO: Verify handling of multiple video URLs per profile.
- TODO: Confirm parsing consistency across Snapchat UI changes.

### 📚 References

- [Apify Actor README Guide](https://docs.apify.com/actors/README)
- [Apify Input & Output Docs](https://docs.apify.com/input-output)
- [Actor in Console](https://console.apify.com/actors/GdWCkxBtKWOsKjdch/information/latest/readme)

### 🧐 Inferred from main.py

- Actor scrapes public Snapchat profiles.
- Supports Apify Proxy and custom proxies.
- Outputs stored in default dataset (`ALL_RESULTS`).
- TODOs include proxy rotation and multi-video handling.

# Actor input Schema

## `startUrls` (type: `array`):

List of one or more Snapchat profile URLs to scrape

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

Use Apify Proxy or your own HTTP proxies

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.snapchat.com/@loganpaul"
    }
  ],
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.snapchat.com/@loganpaul"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("neuro-scraper/snapchat-profile-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 = {
    "startUrls": [{ "url": "https://www.snapchat.com/@loganpaul" }],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("neuro-scraper/snapchat-profile-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 '{
  "startUrls": [
    {
      "url": "https://www.snapchat.com/@loganpaul"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call neuro-scraper/snapchat-profile-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=neuro-scraper/snapchat-profile-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Snapchat Profile Scraper",
        "description": "Snapchat Profile Scraper. Get all the snapchat public profile data as you need   —  Fast ⚡ | Accurate 🎯 | Automated 🤖",
        "version": "0.0",
        "x-build-id": "JZIRmJ5fAU0OgdIJc"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/neuro-scraper~snapchat-profile-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-neuro-scraper-snapchat-profile-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/neuro-scraper~snapchat-profile-scraper/runs": {
            "post": {
                "operationId": "runs-sync-neuro-scraper-snapchat-profile-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/neuro-scraper~snapchat-profile-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-neuro-scraper-snapchat-profile-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",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "List of one or more Snapchat profile URLs to scrape",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Use Apify Proxy or your own HTTP proxies",
                        "default": {}
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
