# Snapchat API
> 5 endpoints for live Snapchat data — user search, detail, related, spotlights.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/snapchat-api/..."
```

## Pricing
- **Free** (Free) — 100 calls/Mo, 1 req/s
- **Basic** ($15/Mo) — 25,000 calls/Mo, 10 req/s
- **Pro** ($49/Mo) — 100,000 calls/Mo, 20 req/s
- **Mega** ($149/Mo) — 500,000 calls/Mo, 50 req/s

## Endpoints

### Users

#### `GET /v1/users/search` — Search users

Snapchat-Nutzer-Suche per Volltext. Query: query.

**Parameters:**
- `query` (query, required, string) — Snapchat search text Example: `jlo`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/snapchat-api/v1/users/search?query=jlo"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "users": [
            {
                "id": "d278c2a0-5c8e-447b-8711-cfca0c15ca07",
                "link": "https://www.snapchat.com/add/jlo",
                "username": "jlo",
                "is_popular": false,
                "is_official": false,
                "snap_pro_id": "a2d94d79-6df1-46de-a0a8-75b63b26bcbd",
                "display_name": "Jonathan",
                "profile_logo_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvRWFaNEpvN3hBajNUYVVtbElPUVM3P2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-04T13:59:42.455Z",
        "request_id": "cbd35eff-fa90-4866-a7e6-9d9cb3c0db48"
    },
    "status": "ok",
    "message": "Users retrieved successfully",
    "success": true
}
```

#### `GET /v1/users/detail` — User detail

Vollständiges Profil per Username.

**Parameters:**
- `username` (query, required, string) — Snapchat username Example: `jlo`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/snapchat-api/v1/users/detail?username=jlo"
```

**Response:**
```json
{
    "data": {
        "id": "d278c2a0-5c8e-447b-8711-cfca0c15ca07",
        "bio": "🤝",
        "link": "https://www.snapchat.com/add/jlo",
        "badge": 0,
        "title": "Jonathan",
        "address": null,
        "category": "public-profile-category-v3-people",
        "username": "jlo",
        "has_story": false,
        "subcategory": "public-profile-subcategory-v3-entrepreneur",
        "website_url": null,
        "display_name": "Jonathan",
        "subscriber_count": 57200,
        "snapcode_image_url": "https://app.snapchat.com/web/deeplink/snapcode?username=jlo&type=SVG&bitmoji=enable",
        "business_profile_id": "a2d94d79-6df1-46de-a0a8-75b63b26bcbd",
        "profile_picture_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvRWFaNEpvN3hBajNUYVVtbElPUVM3P2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
        "creation_timestamp_ms": 1602696719006,
        "has_curated_highlights": false,
        "has_spotlight_highlights": false,
        "last_update_timestamp_ms": 1776456953897
    },
    "meta": {
        "timestamp": "2026-05-04T13:59:42.906Z",
        "request_id": "060525e6-f31e-4951-835f-761576750787"
    },
    "status": "ok",
    "message": "User detail retrieved successfully",
    "success": true
}
```

#### `GET /v1/users/id` — User ID

Numerische User-ID per Username.

**Parameters:**
- `username` (query, required, string) — Snapchat username Example: `jlo`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/snapchat-api/v1/users/id?username=jlo"
```

**Response:**
```json
{
    "data": {
        "id": "d278c2a0-5c8e-447b-8711-cfca0c15ca07",
        "username": "jlo",
        "business_profile_id": "a2d94d79-6df1-46de-a0a8-75b63b26bcbd"
    },
    "meta": {
        "timestamp": "2026-05-04T13:59:43.300Z",
        "request_id": "05df243f-1e28-4181-92a0-5a75dc08f536"
    },
    "status": "ok",
    "message": "User ID retrieved successfully",
    "success": true
}
```

#### `GET /v1/users/related` — Related users

Empfohlene/verwandte Profile.

**Parameters:**
- `username` (query, required, string) — Snapchat username Example: `jlo`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/snapchat-api/v1/users/related?username=jlo"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "users": [
            {
                "id": null,
                "bio": null,
                "link": "https://www.snapchat.com/add/jbalvin",
                "badge": 0,
                "title": "Juan Balvin",
                "address": null,
                "category": null,
                "username": "jbalvin",
                "has_story": false,
                "subcategory": null,
                "website_url": null,
                "display_name": "Juan Balvin",
                "subscriber_count": 0,
                "snapcode_image_url": null,
                "business_profile_id": "190b03c1-a4d3-4b2e-92d5-17f5bf93ea7b",
                "profile_picture_url": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvWW1tSUZkY2JlZTNrZVl5bVlQbEpxP2JvPUVnMGFBQm9BTWdFRVNBSlFDR0FCJnVjPTg._RS0,640_FMpng",
                "creation_timestamp_ms": null,
                "has_curated_highlights": false,
                "has_spotlight_highlights": false,
                "last_update_timestamp_ms": null
            },
            {
                "id": null,
                "bio": null,
                "link": "https://www.snapchat.com/add/jlobts",
                "badge": 1,
                "title": "Jennifer Lopez",
                "address": null,
                "category": null,
                "username": "jlobts",
                "has_story": false,
                "subcategory": null,
                "website_url
…(truncated, see openapi.json for full schema)
```

### Spotlights

#### `GET /v1/spotlights/search` — Search spotlights

Snapchat-Spotlight-Suche per Volltext.

**Parameters:**
- `query` (query, required, string) — Search text Example: `jlo`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/snapchat-api/v1/spotlights/search?query=jlo"
```

**Response:**
```json
{
    "data": {
        "count": 24,
        "spotlights": [
            {
                "onTap": {
                    "action": {
                        "$case": "playStoryCard",
                        "playStoryCard": {
                            "storyId": "827dc3860c14559fd9922d9cd2dc43dd"
                        }
                    }
                },
                "ageText": "",
                "storyId": "827dc3860c14559fd9922d9cd2dc43dd",
                "mediaKey": "LtjdUUjPe2M+Bkj1urtFxqRigYuhH3AZiJaOvl595AA=",
                "mediaUrl": "https://bolt-gcdn.sc-cdn.net/z/H7A1mk5pLgIwohbgaFGo7.27.IRZXSOY?mo=GlAaCTIBeUgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBLAgbEhsKGQjIz1ogAUoPCgqWAVlUW1JWWlpbEPQDaAIiCxIAKgdJUlpYU09ZkAOyQQ%3D%3D&uc=46",
                "playCount": "",
                "rawSnapId": "W7_EDlXWTBiXAEEniNoMPwAAYdHlhbnJiYmphAZbbOAVQAZbbN_3KAAAAAQ",
                "teaserText": "",
                "creatorName": "",
                "thumbnailIv": "NzUfCFZJijByXisMOOdkKg==",
                "thumbnailUrl": "https://bolt-gcdn.sc-cdn.net/z/H7A1mk5pLgIwohbgaFGo7.1025?mo=Gh8aCTIBeUgCUC5gAVoIRGZGRnJhbWWiAQcIgQgiAhIA&uc=46",
                "creatorUsername": "",
                "creatorDisplayName": "",
                "creatorNameLogoUrl": "",
                "creatorNameDecorators": [],
                "teaserTextMaxNumLines": 0,
                "creatorNameMaxNumLines": 0,
                "bottomLeadingUiElements": []
            },
            {
         
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/snapchat-api
OpenAPI spec: https://www.oanor.com/api/snapchat-api/openapi.json