POST /v1/data/snapchat/profiles/run
Pricing: $0.003 per profile ($3.00 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Example
curl -X POST "https://api.mindcase.co/v1/data/snapchat/profiles/run?wait=true" \
-H "Authorization: Bearer $MINDCASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"params": {
"usernames": [
"nfl",
"lemonde",
"fcbarcelona"
]
}
}'
import os, requests
r = requests.post(
"https://api.mindcase.co/v1/data/snapchat/profiles/run",
params={"wait": "true"},
headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
json={"params": {
"usernames": [
"nfl",
"lemonde",
"fcbarcelona"
]
}},
)
job = r.json()
rows = job.get("data", []) # if job["status"] == "running", poll /v1/jobs/{job_id}/results
const r = await fetch("https://api.mindcase.co/v1/data/snapchat/profiles/run?wait=true", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ params: {
"usernames": [
"nfl",
"lemonde",
"fcbarcelona"
]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
Response fields
Each row indata is one profile, keyed by these fields.
| Field | Name | Type |
|---|---|---|
profileUrl | Profile URL | url |
username | Username | text |
displayName | Display Name | text |
bio | Bio | text |
subscribers | Subscribers | number |
website | Website | text |
verified | Verified | boolean |
accountType | Account Type | text |
category | Category | text |
subcategory | Subcategory | text |
location | Location | text |
profilePicture | Profile Picture | url |
coverImage | Cover Image | url |
snapcode | Snapcode | url |
hasHighlights | Has Highlights | boolean |
hasSpotlight | Has Spotlight | boolean |
relatedAccounts | Related Accounts | array |
accountCreated | Account Created | text |
lastUpdated | Last Updated | text |
businessProfileId | Business Profile ID | text |
Example response
Abridged: long text and lists are shortened.{
"job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
"agent": "snapchat/profiles",
"status": "completed",
"row_count": 1,
"truncated": false,
"data": [
{
"accountType": "public",
"relatedAccounts": [
"nba",
"eagles"
],
"accountCreated": "2018-05-23T20:41:49.878Z",
"bio": "Official Snapchat account of the National Football League!",
"profileUrl": "https://www.snapchat.com/add/nfl",
"profilePicture": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvT3NjakFOS0dwSWh1VzQwek9qRnowP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
"username": "nfl",
"businessProfileId": "21f4e252-2d8b-44f7-a7ac-21a767730b7f",
"category": "public-profile-category-v3-business-group",
"subscribers": 2339400,
"lastUpdated": "2026-11-06T05:13:36.002Z",
"hasHighlights": true,
"coverImage": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZkVQMEwwTWt2WmFnWWs1NlNGd3hkP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,1080_FMjpeg",
"location": "US",
"snapcode": "https://gcp.api.snapchat.com/web/deeplink/snapcode?username=nfl&type=SVG&bitmoji=enable",
"website": null,
"verified": true,
"displayName": "NFL Official",
"hasSpotlight": true,
"subcategory": "public-profile-subcategory-v3-sports-league"
}
]
}