# Apple Podcasts Search API Documentation

<p>Search Apple Podcasts by keyword and country. Each result is the full public record with genres, track count, feed URL and full size artwork. Ids are returned unchanged and are accepted by the show, episodes and ratings endpoints. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/apple-podcasts-api/apple_podcasts_search](https://scrappa.co/docs/apple-podcasts-api/apple_podcasts_search)
- **API group:** Apple Podcasts API
- **Endpoint:** `GET https://scrappa.co/api/apple-podcasts/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. |
| `country` | string | No | Storefront: us or de, default us. |
| `limit` | integer | No | Results to return, 1 to 200, default 25. |

## Example response

```json
{
    "data": {
        "limit": 25,
        "query": "example",
        "country": "US",
        "results": [
            {
                "genres": [
                    "Comedy"
                ],
                "feedUrl": "https://example.com/feed.xml",
                "trackCount": 120,
                "collectionId": 1200361736,
                "artworkUrl600": "https://example.com/art/600x600bb.jpg",
                "collectionName": "Example Show",
                "primaryGenreName": "Comedy"
            }
        ],
        "result_count": 1
    },
    "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)
