# Podchaser Search API Documentation

<p>Search the public Podchaser catalogue by keyword. Each result is the full public podcast entity with id, slug, title, description, categories, networks, creator summary, rating, rating count, review count, follower count, episode count and full size image URL. Sort by relevance or newest and page with offset. The upstream total is a cap, so has_more is the paging signal. 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_search](https://scrappa.co/docs/podchaser-api/podchaser_search)
- **API group:** Podchaser API
- **Endpoint:** `GET https://scrappa.co/api/podchaser/search`

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Search term. |
| `limit` | integer | No | Results to return, 1 to 100, default 25. |
| `offset` | integer | No | Result offset. |
| `sort` | string | No | relevance or newest. |

## Example response

```json
{
    "data": {
        "sort": "relevance",
        "query": "news",
        "results": [
            {
                "id": 243479,
                "slug": "the-daily",
                "title": "The Daily",
                "rating": 4.6,
                "image_url": "https://example.com/art.jpg",
                "rating_count": 1200,
                "review_count": 340
            }
        ],
        "pagination": {
            "limit": 25,
            "total": 10000,
            "offset": 0,
            "has_more": true,
            "returned": 1,
            "total_is_cap": true
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. 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)
