# Snapchat Profile Scraper (`parsebird/snapchat-profile-scraper`) Actor
Extract Snapchat profile data: username, display name, bio, subscriber count, category, website, images, address, story status, and timestamps. Export as JSON, CSV, Excel.
- **URL**: https://apify.com/parsebird/snapchat-profile-scraper.md
- **Developed by:** [ParseBird](https://apify.com/parsebird) (community)
- **Categories:** Social media, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.60 / 1,000 snapchat profile scrapeds
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/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
### Snapchat Profile Scraper
Snapchat Profile Scraper extracts public profile data from [Snapchat](https://www.snapchat.com/) by username, @handle, or profile URL.
Get structured Snapchat profile metadata including display name, bio, subscriber count, category IDs, website, images, address, story status, highlights, and timestamps.
##### Copy to your AI assistant
Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.
```text
Use Apify Actor parsebird/snapchat-profile-scraper to extract public Snapchat profile data. Call it with ApifyClient actor("parsebird/snapchat-profile-scraper").call(run_input={"usernames":["fcbarcelona"],"proxyConfiguration":{"useApifyProxy":false}}). Inputs: usernames array required, accepts usernames, @handles, or Snapchat profile URLs; proxyConfiguration optional and disabled by default. Output fields include username, title, snapcodeImageUrl, badge, categoryStringId, subcategoryStringId, subscriberCount, bio, websiteUrl, profilePictureUrl, address, hasCuratedHighlights, hasSpotlightHighlights, mutableName, publisherType, squareHeroImageUrl, primaryColor, hasStory, creationTime, lastUpdateTime. API docs: https://docs.apify.com/api/client/python/. Token: https://console.apify.com/account/integrations.
````
### What is Snapchat Profile Scraper?
**Snapchat Profile Scraper** is a Snapchat data extraction tool for collecting public profile metadata from Snapchat usernames. It works as a lightweight **Snapchat API alternative** when you need structured profile information for social media research, creator monitoring, lead enrichment, or competitor analysis.
Paste one or more usernames such as `fcbarcelona` or a public Snapchat profile URL such as `https://www.snapchat.com/@fcbarcelona`, then run the actor on Apify. Results can be downloaded from the dataset in JSON, CSV, Excel, XML, RSS, or HTML through Apify exports.
### What can Snapchat Profile Scraper do?
- Extract public Snapchat profile metadata from usernames, @handles, `/@username` URLs, and `/add/username` URLs.
- Return profile fields such as title, bio, subscriber count, category, subcategory, website, images, address, story status, and timestamps.
- Run one-off profile lookups or schedule recurring monitoring with [Apify schedules](https://docs.apify.com/platform/schedules).
- Use Apify API access, webhooks, and [integrations](https://apify.com/integrations) to send Snapchat data to Google Sheets, Make, Zapier, Slack, or your own database.
- Export clean datasets as JSON, CSV, Excel, XML, RSS, or HTML from the Apify Console.
- Use optional proxy settings for enhanced reliability if direct requests are blocked.
### What data can you extract from Snapchat?
| Field | Description |
|-------|-------------|
| `username` | Snapchat public profile username |
| `title` | Display name or public profile title |
| `subscriberCount` | Public subscriber count when Snapchat exposes it |
| `bio` | Profile biography text |
| `websiteUrl` | Website or external link connected to the profile |
| `profilePictureUrl` | Public profile image URL |
| `snapcodeImageUrl` | Snapcode image URL for the username |
| `categoryStringId` | Snapchat public profile category identifier |
| `subcategoryStringId` | Snapchat public profile subcategory identifier |
| `address` | Public address or location text |
| `hasStory` | Whether Snapchat reports an active story |
| `creationTime` | Profile creation timestamp when available |
| `lastUpdateTime` | Last profile update timestamp when available |
### How to scrape Snapchat profiles
1. Open [Snapchat Profile Scraper](https://apify.com/parsebird/snapchat-profile-scraper) on Apify.
2. Add one or more Snapchat usernames, @handles, or profile URLs in the `Usernames` input.
3. Leave proxy settings disabled for a quick test, or enable Apify Proxy if direct requests are unreliable.
4. Click **Start** and wait for the run to finish.
5. Open the dataset and export the Snapchat profile data as JSON, CSV, Excel, XML, RSS, or HTML.
You can also run the actor through the [Apify API](https://docs.apify.com/api/v2) or schedule it to monitor profile metadata over time.
### How much does it cost to scrape Snapchat?
This actor uses pay-per-event pricing. One event equals one Snapchat public profile successfully pushed to the dataset.
| Event | Free, Bronze, Silver | Gold |
|-------|----------------------|------|
| `profile-scraped` | $0.0029 per profile, **$2.90 per 1,000** | $0.0026 per profile, **$2.60 per 1,000** |
**Is there a free trial?** Apify provides free platform credits for new users where applicable, so you can test small runs before scaling. Pricing is based on successfully extracted profiles, not on usernames that are skipped because they are invalid or unavailable.
### Input / Output
Input example:
```json
{
"usernames": [
"fcbarcelona"
],
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
Output example:
```json
[
{
"username": "fcbarcelona",
"title": "FC Barcelona",
"snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=fcbarcelona&type=SVG&bitmoji=enable",
"badge": 1,
"categoryStringId": "public-profile-category-v3-business-group",
"subcategoryStringId": "public-profile-subcategory-v3-sports-team",
"subscriberCount": "4017600",
"bio": "FC Barcelona's official Snapchat account #ForcaBarca",
"websiteUrl": "http://barca.link/Q9m450Z25gY",
"profilePictureUrl": "https://cf-st.sc-cdn.net/...",
"address": "Barcelona, Catalunya, Espana",
"hasCuratedHighlights": true,
"hasSpotlightHighlights": true,
"mutableName": "",
"publisherType": "",
"squareHeroImageUrl": "",
"primaryColor": "",
"hasStory": false,
"creationTime": "2019-05-21T18:25:09.912Z",
"lastUpdateTime": "2026-07-01T08:04:02.657Z"
}
]
```
### Python API example
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("parsebird/snapchat-profile-scraper").call(run_input={
"usernames": ["fcbarcelona", "realmadrid"],
"proxyConfiguration": {"useApifyProxy": False},
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
```
### JavaScript API example
```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('parsebird/snapchat-profile-scraper').call({
usernames: ['fcbarcelona', 'realmadrid'],
proxyConfiguration: { useApifyProxy: false },
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```
### Is it legal to scrape Snapchat?
**Is it legal to scrape public Snapchat profile data?** Scraping publicly available web data is generally allowed in many jurisdictions, but your use case, location, and the type of data collected matter. This actor is designed for public profile metadata only and does not log in, bypass access controls, or scrape private Snapchat content. Review Snapchat's terms, privacy requirements, and applicable laws before using the data. For general context, read Apify's guide on [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/).
### Other Snapchat scrapers / Related Actors
- [YouTube Search Scraper](https://apify.com/parsebird/youtube-search-scraper) - Extract videos, channels, playlists, shorts, and metadata from YouTube search.
- [Truth Social Scraper](https://apify.com/parsebird/truth-social-scraper) - Extract public Truth Social posts and profile-related social data.
- [Truth Social Comment Scraper](https://apify.com/parsebird/truth-social-comment-scraper) - Extract public comments from Truth Social posts.
- [Website Contact Finder](https://apify.com/parsebird/website-contact-finder) - Find emails, phone numbers, and social links from websites.
### FAQ
**Can I scrape Snapchat profiles in Python?**
Yes. Use the Python API example above with `ApifyClient` to run Snapchat Profile Scraper and stream dataset items into your script.
**Can I use this as a Snapchat scraper API?**
Yes. The actor can be called through Apify's REST API or official clients, making it useful as a Snapchat scraper API for public profile metadata.
**Does the actor scrape private Snapchat data?**
No. It only extracts public profile data available from Snapchat public profile pages.
**Can I schedule recurring Snapchat profile monitoring?**
Yes. Use Apify schedules to run the actor daily, weekly, hourly, or at a custom interval.
**What happens if a username does not exist?**
The actor logs a warning, skips that username, and continues with the remaining profiles.
**Can I export Snapchat data to Google Sheets or Excel?**
Yes. Export directly as Excel or CSV, or use Apify integrations to send results to Google Sheets, Make, Zapier, Slack, or other tools.
**Where can I report issues or request fields?**
Use the Issues tab on the Apify actor page and include example usernames so the behavior can be reproduced.
# Actor input Schema
## `usernames` (type: `array`):
Add Snapchat usernames, @handles, or public profile URLs. Examples: fcbarcelona, @realmadrid, https://www.snapchat.com/@fcbarcelona.
## `proxyConfiguration` (type: `object`):
Optional proxy settings for enhanced reliability. Leave disabled for most runs.
## Actor input object example
```json
{
"usernames": [
"fcbarcelona",
"realmadrid"
],
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `dataset` (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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"usernames": [
"fcbarcelona",
"realmadrid"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("parsebird/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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "usernames": [
"fcbarcelona",
"realmadrid",
] }
# Run the Actor and wait for it to finish
run = client.actor("parsebird/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 '{
"usernames": [
"fcbarcelona",
"realmadrid"
]
}' |
apify call parsebird/snapchat-profile-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=parsebird/snapchat-profile-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Snapchat Profile Scraper",
"description": "Extract Snapchat profile data: username, display name, bio, subscriber count, category, website, images, address, story status, and timestamps. Export as JSON, CSV, Excel.",
"version": "1.0",
"x-build-id": "fSkcNNNAZ99MQPFGO"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parsebird~snapchat-profile-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parsebird-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/parsebird~snapchat-profile-scraper/runs": {
"post": {
"operationId": "runs-sync-parsebird-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/parsebird~snapchat-profile-scraper/run-sync": {
"post": {
"operationId": "run-sync-parsebird-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": [
"usernames"
],
"properties": {
"usernames": {
"title": "Usernames",
"type": "array",
"description": "Add Snapchat usernames, @handles, or public profile URLs. Examples: fcbarcelona, @realmadrid, https://www.snapchat.com/@fcbarcelona.",
"items": {
"type": "string"
}
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Optional proxy settings for enhanced reliability. Leave disabled for most runs.",
"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
}
}
}
}
}
}
}
}
}
}
```