# Threads Profile

Read a public Threads profile by username. Returns the profile identity, biography, follower and following counts, verification status, profile image, profile tags, transparency label, and any posts the page carries inline. A username that is not on Threads returns a 404 and is not billed. A private or restricted profile returns a non-billable 404 with its own error code, distinct from a missing account.

- **Documentation:** [https://scrappa.co/docs/threads-api/threads_profile](https://scrappa.co/docs/threads-api/threads_profile)
- **API group:** Threads API
- **Endpoint:** `GET https://scrappa.co/api/threads/profile`

## 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 |
| --- | --- | --- | --- |
| `username` | string | Yes | Threads handle without the leading @. |

## Example response

```json
{
    "meta": {
        "attempts": 1,
        "duration_ms": 940,
        "endpoint_family": "threads_profile"
    },
    "user": {
        "pk": "17841400000000000",
        "username": "natgeo",
        "biography": "We inspire people to care for the planet.",
        "full_name": "National Geographic",
        "is_verified": true,
        "profile_tags": [
            {
                "name": "science"
            }
        ],
        "follower_count": 38100000,
        "text_post_app_is_private": false
    },
    "posts": [],
    "search_parameters": {
        "engine": "threads_profile",
        "username": "natgeo"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Returned, and not billed, when the handle, post code or hashtag does not exist or is not publicly available. |
| 422 | Validation Error | Returned, and not billed, when a parameter is missing or outside its allowed range. |
| 503 | Service Unavailable | A retryable, non-billable failure. The upstream returned a degraded or unreadable response, or the request budget ran out. |

## 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)