Snapchat Profile
A Snapchat public profile can expose a username, display name, biography, avatar, cover, website, account flags, location, and visible profile counts. This focused lookup turns one known username into a normalized account snapshot for enrichment, review, or later comparison.
Features
- Exact username lookupResolve one known Snapchat username per task, with or without a single leading @, instead of searching for accounts.
- Normalized profile identityReturn available username, display name, biography, public URL, and stable source identifier in an AccountItem record.
- Profile media and contextKeep available avatar, cover, website, and location fields separate for display, indexing, and enrichment workflows.
- Visible account signalsCapture available verification and privacy flags plus follower, following, and post counts at collection time.
Parameters
| Parameters | Required | Description |
|---|---|---|
username | Required | Required Snapchat username. Supply one optional leading @ followed by 1–64 ASCII letters, digits, periods, underscores, or hyphens; spaces, profile URLs, and other characters are rejected. |
How to Use
Submit one accepted username, wait for the asynchronous task, then read its normalized profile result.
- Choose one known Snapchat username using letters, digits, periods, underscores, or hyphens; one leading @ is optional.
- Send username to /v1/snapchat/profile and retain the returned task_id.
- Poll /v1/tasks/{task_id} until the task reaches succeeded or failed.
- After success, read data.results.items; this detail lookup normally returns one profile or an empty list.
curl -X POST "https://api.socq.ai/v1/snapchat/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"zane"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after the task succeedsBest Use Cases
- Known-account enrichment: Add public identity, biography, profile media, website, and available counts to a record that already contains a Snapchat username.
- Selected profile review: Present one public account in a consistent profile card or review queue without mixing in Stories, Spotlights, or account-management actions.
- Public snapshot comparison: Store collected_at with successive results to compare public profile text, account flags, media, or visible counts over time.
Pro Tips
- Use the same canonical username form in your own records even though the request accepts one leading @.
- Submit exactly one username per task; batching, profile URLs, and results_limit are outside this endpoint contract.
- Treat accepted syntax as input validation, not proof that the username resolves to an accessible public profile.
- Handle website, location, profile media, account flags, and individual metrics as optional fields.
- Keep collected_at with every stored result because profile text and visible counts are point-in-time values.
Related APIs
Use these APIs when you need a different type of public Snapchat data.
- Snapchat Spotlight API — Retrieve one known public Snapchat Spotlight with normalized creator, caption, media, audio, timestamp, duration, and visible engagement fields when available.
- Snapchat Spotlight Comments API