# Snapchat Details API (snapchat.profile)

- Canonical page: [https://everyinfra.com/en/snapchat-api/profile](https://everyinfra.com/en/snapchat-api/profile?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "snapchat", "action": "profile", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

Snapchat Details reads the public profile of one Snapchat creator or business account and returns a single record: display name, bio, account type, category and subcategory, subscriber count, verification, website and address, the number of Lenses, Highlights and Spotlight videos, whether a Story is viewable now, plus the avatar, header image and Snapcode. Brand and influencer teams use it to size up an account before working with it and to track its subscriber count over time.

Pass the username, with or without @, or a snapchat.com/add/<name> or snapchat.com/@<name> link; only public profile information is read, never private chats or friends-only Stories. `lens_count` is a core output measure for creator accounts, and `category` follows Snapchat's own taxonomy rather than a cross-platform one. `snapcode_url` links to the image of the yellow code people scan to follow the account, and `business_profile_id` identifies a business account.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=snapchat&action=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | Specifies a public creator handle, accepted as a plain username (with optional `@` prefix) or a full snapchat.com profile URL. This parameter retrieves public profile data for `profile`, current public stories for `stories`, or Spotlight short videos for `user_posts`. Private chats and friends-only stories are not accessible. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| business_profile_id | platform-native meaning |
| username | Username (@handle). |
| display_name | Display name; can differ from username. |
| bio | Profile bio written by the account; may contain line breaks and emoji. |
| profile_type | platform-native meaning |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| subcategory | platform-native meaning |
| subscriber_count | platform-native meaning |
| is_verified | Whether the platform verified the account. null means it cannot be determined. |
| website | External website entered by the account or business. |
| address | Full address, passed through as is. |
| has_story | platform-native meaning |
| lens_count | platform-native meaning |
| highlight_count | platform-native meaning |
| spotlight_count | platform-native meaning |
| url | Link to the record on the platform. |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| snapcode_url | platform-native meaning |
| hero_image_url | platform-native meaning |
| created_at | Creation time, same format as posted_at. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| related_accounts | platform-native meaning |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "snapchat",
  "action": "profile",
  "params": {
    "username": "<SNAPCHAT_USERNAME>"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "snapchat",
        "action": "profile",
        "params": {
            "username": "<SNAPCHAT_USERNAME>",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "snapchat",
  "action": "profile",
  "results": {
    "business_profile_id": …,
    "username": …,
    "display_name": …,
    "bio": …,
    "profile_type": …,
    "category": …,
    "subcategory": …,
    "subscriber_count": …,
    "is_verified": …,
    "website": …,
    "address": …,
    "has_story": …,
    "lens_count": …,
    "highlight_count": …,
    "spotlight_count": …,
    "url": …,
    "avatar_url": …,
    "snapcode_url": …,
    "hero_image_url": …,
    "created_at": …,
    "platform": …,
    "related_accounts": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Which forms of `username` work?

The account name, with or without @, or a profile link shaped like snapchat.com/add/<name> or snapchat.com/@<name>. A display name does not identify the account, and a link to a single Spotlight video belongs to the Snapchat Video details capability rather than this one.

### Where is the follower count?

This profile reports audience size as `subscriber_count`, the number of subscribers; there is no separate follower field. Read it alongside `profile_type`, which separates personal, public figure and business accounts, before you compare reach across accounts.

### What does `has_story` tell me?

It is true when the account has a Story that can be viewed at the moment of the call. To read the Stories themselves, pass the same username to the Snapchat Stories capability, which returns the account's current public Stories.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=snapchat
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
