# Truth Social Profile API Documentation

Look up a public Truth Social account by handle and receive the complete profile: display name, plain-text bio, avatar and header images, creation date, follower, following and status counters, account fields, emojis, location and premium flag. One lookup returns the whole profile, so no enrichment call is made and no second credit is spent. Handles are case-insensitive and a leading @ is accepted. An unknown handle returns 404.

- **Documentation:** [https://scrappa.co/docs/truthsocial-api/truthsocial_profile](https://scrappa.co/docs/truthsocial-api/truthsocial_profile)
- **API group:** Truth Social API
- **Endpoint:** `GET https://scrappa.co/api/truthsocial/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 | Account handle without or with a leading @. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/truthsocial/profile?username=realdonaldtrump"
```

## Example response

```json
{
    "success": true,
    "profile": {
        "id": "107780257626128497",
        "acct": "realdonaldtrump",
        "username": "realdonaldtrump",
        "display_name": "Donald J. Trump",
        "note": "45th & 47th President of the United States",
        "followers_count": 10500000,
        "following_count": 30,
        "statuses_count": 150000,
        "locked": false,
        "bot": false
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not found | No public account, truth, tag or video matches the given identifier. One upstream lookup was performed and the request was not charged. |
| 422 | Validation error | A required identifier was missing or malformed. No upstream request was performed and nothing was charged. |
| 503 | Upstream unavailable | Truth Social could not be reached after safe retries. The request is not billed. A challenge, a regional block or a rate limit on our side is reported this way, never as a rate limit against you. The specific cause is recorded on your request log, not in this response. |

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