# Truth Social Live Shows API Documentation

Return the currently listed Truth Social live shows with their channel id, name, redirect url, light and dark thumbnails, and the nested program block that carries the broadcast start and end time. That program window is the closest thing the platform exposes to availability information, so it is returned rather than flattened.

- **Documentation:** [https://scrappa.co/docs/truthsocial-api/truthsocial_live_shows](https://scrappa.co/docs/truthsocial-api/truthsocial_live_shows)
- **API group:** Truth Social API
- **Endpoint:** `GET https://scrappa.co/api/truthsocial/live-shows`

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

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/truthsocial/live-shows"
```

## Example response

```json
{
    "success": true,
    "live_shows": [
        {
            "channel_id": "1",
            "name": "Truth Social Live",
            "redirect_url": "https://truthsocial.com/live/1"
        }
    ],
    "count": 1
}
```

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