# Linktree Batch Profiles API Documentation

Retrieve up to 10 public Linktree profiles in one call. Pass a comma-separated list of usernames. Each username costs one upstream request. Only found profiles are returned and billed; unknown usernames are omitted from the results.

- **Documentation:** [https://scrappa.co/docs/linktree-api/linktree_profiles](https://scrappa.co/docs/linktree-api/linktree_profiles)
- **API group:** Linktree API
- **Endpoint:** `GET https://scrappa.co/api/linktree/profiles`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `usernames` | string | Yes | Comma-separated Linktree usernames, up to 10. Example: linktree,spotify,vannise2019. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/linktree/profiles?usernames=linktree%2Cspotify%2Cvannise2019"
```

## Example response

```json
{
    "success": true,
    "data": [
        {
            "username": "linktree",
            "page_title": "Linktree",
            "description": null,
            "verified": false,
            "profile_image": null,
            "is_profile_verified": false,
            "has_sensitive_content": false,
            "content_gating": null,
            "theme": {
                "key": "leaf",
                "mode": "light"
            },
            "links": [
                {
                    "id": "589138106",
                    "title": "Linktree's Linktree",
                    "url": "https://linktr.ee/linktr.ee",
                    "type": "CLASSIC",
                    "position": 1,
                    "thumbnail": "https://ugc.production.linktr.ee/b2f4b99c-linktr.ee.jpeg",
                    "children": [],
                    "meta_data": {
                        "title": "Welcome to our Linktree | Linktree",
                        "description": "A place to discover everything going on in the world of Linktree"
                    }
                }
            ],
            "pinned_links": [],
            "socials": []
        },
        {
            "username": "spotify",
            "page_title": "Spotify",
            "description": null,
            "verified": true,
            "profile_image": null,
            "is_profile_verified": true,
            "has_sensitive_content": false,
            "content_gating": null,
            "theme": {
                "key": "leaf",
                "mode": "light"
            },
            "links": [
                {
                    "id": "61298474",
                    "title": "Spotify's Linktree",
                    "url": "https://open.spotify.com/",
                    "type": "CLASSIC",
                    "position": 1,
                    "thumbnail": null,
                    "children": [],
                    "meta_data": null
                }
            ],
            "pinned_links": [],
            "socials": []
        },
        {
            "username": "vannise2019",
            "page_title": "Vannise",
            "description": null,
            "verified": false,
            "profile_image": null,
            "is_profile_verified": false,
            "has_sensitive_content": false,
            "content_gating": null,
            "theme": {
                "key": "leaf",
                "mode": "light"
            },
            "links": [],
            "pinned_links": [],
            "socials": [
                {
                    "type": "instagram",
                    "url": "https://instagram.com/vannise2019",
                    "position": 1
                }
            ]
        }
    ],
    "meta": {
        "endpoint_family": "profile_detail",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Upstream Unavailable | The profiles could not be read from their source right now. Please retry. |
| 503 | Parse Error | The Linktree response could not be parsed. Please retry. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)