Api | Docs | Audioscrape

Authentication

All API requests require an API key. Pass it via:

Authorization header (recommended): Authorization: Bearer YOUR_API_KEY
Query parameter: ?api_key=YOUR_API_KEY

Get your API key: Sign up (free tier includes 10 searches/month and 1 API key), then visit Profile > API Keys.

Pricing

Free

$0/mo

10 searches/month
1 API key
All endpoints

Basic

$35/mo

50 searches/month
3 API keys
All endpoints
Hybrid search

Pro

$129/mo

Unlimited searches
10 API keys
All endpoints
Hybrid search
Priority support

View full pricing →

Agent Checkout (Programmatic Upgrade)

AI agents can initiate a subscription upgrade on behalf of their user:

curl -X POST "https://www.audioscrape.com/api/agent/payment-link" \
     -H "Content-Type: application/json" \
     -d '{"plan": "basic", "email": "[email protected]"}'

Returns a Stripe payment link the agent can present to the user. No API key required for this endpoint.

Endpoints

Search

POST /api/v1/search

Search podcast transcriptions with text or semantic search.

curl -X POST "https://www.audioscrape.com/api/v1/search" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"query": "artificial intelligence", "limit": 10}'

POST /api/search

Legacy search endpoint (also requires API key for programmatic clients).

Full search docs →

Charts & Rankings

GET /api/v1/charts/podcasts?country=us&platform=apple&limit=50

Top podcasts from Apple/Spotify charts.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://www.audioscrape.com/api/v1/charts/podcasts?country=us"

GET /api/v1/charts/episodes?country=us&platform=apple&limit=50

Top episodes by chart ranking.

GET /api/v1/charts/podcast/:podcast_id

Ranking history for a specific podcast.

Podcasts

GET /api/v1/podcasts?q=tech&language=en&limit=20&offset=0

Search podcasts by title with optional language filter.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://www.audioscrape.com/api/v1/podcasts?q=technology"

GET /api/v1/podcasts/:podcast_id/episodes?limit=20&offset=0

Paginated episodes for a podcast.

GET /api/public/podcasts/:podcast_id

Full podcast detail with metadata and episode count.

Episodes

GET /api/v1/episodes/recent?limit=20&offset=0

Globally recent episodes with transcript availability.

GET /api/public/episodes/:episode_id

Full episode detail with transcript and entities.

Persons / Speakers

GET /api/v1/persons?q=elon&limit=20

Search persons by name.

GET /api/v1/persons/:slug

Person detail with episode appearances.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://www.audioscrape.com/api/v1/persons/elon-musk"

Entities (Knowledge Graph)

GET /api/public/entities?q=openai&type=organization&limit=20

Search entities by name with optional type filter.

GET /api/public/entities/:entity_slug

Entity detail with episode mentions.

GET /api/public/trending

Trending search queries and entities.

Notifications

Full notifications docs →

POST /api/v1/notifications

Create a search term notification (webhook + email).

GET /api/v1/notifications

List your notifications.

MCP Server

Audioscrape provides an MCP (Model Context Protocol) server for AI assistants like Claude Desktop. Connect to:

https://mcp.audioscrape.com/mcp

Available MCP tools:

search_audio_content — Search transcriptions
list_recent_episodes — Recent episodes
get_episode_content — Full episode with transcript
browse_podcast — Browse a podcast's episodes
get_trending_topics — Trending searches & entities
search_entities — Knowledge graph search
get_related_content — Related episodes via shared entities
get_chart_rankings — Podcast chart rankings by country
search_podcasts — Search podcasts by title
search_persons — Search speakers/hosts by name
get_person_details — Person info & episode appearances

Error Handling

Status	Code	Meaning
401	`UNAUTHORIZED`	Missing or invalid API key / session
401	`API key required`	Programmatic request without API key (includes signup link)
402	`PAYMENT_REQUIRED`	Feature requires a paid subscription
404	`NOT_FOUND`	Resource not found
429	`SEARCH_LIMIT_EXCEEDED`	Monthly search limit reached — upgrade plan
429	`Too Many Requests`	IP rate limit exceeded (includes retry_after_seconds)

Need Help?

Contact us at [email protected].

API Documentation