# Podchaser Podcast API Documentation

<p>Read one public podcast entity by the numeric id from search. The response is the full public entity with ratings, rating count, review count, weighted rating, creator roles, creator summary, networks, categories, date fields and similar shows. The entity is hydrated by matching the id in a public search result; the default listing is never returned under a requested id. Pass the name from a search result in q, the only lookup this route makes. Podchaser publishes no public review text, so only counts are returned. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/podchaser-api/podchaser_podcast](https://scrappa.co/docs/podchaser-api/podchaser_podcast)
- **API group:** Podchaser API
- **Endpoint:** `GET https://scrappa.co/api/podchaser/podcast`

## 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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Numeric podcast id from search. |
| `q` | string | Yes | The name field from a search result. |

## Example response

```json
{
    "data": {
        "podcast": {
            "id": 243479,
            "slug": "the-daily",
            "title": "The Daily",
            "rating": 4.6,
            "rating_count": 1200,
            "review_count": 340,
            "creator_with_roles": [],
            "weighted_rating_alltime": 4.5,
            "similar_podcasts_details": []
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "podcast"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. Not billed. |
| 404 | Not Found | No public podcast has this id. Not billed. |

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