API / VERSION 1

Reference built for momentum.

REST over HTTPS, JSON everywhere, Bearer authentication and Elasticsearch search-after pagination.

Quickstart
1

Create a free workspace

2

Copy your server key

3

Call /v1/search

Find and resolve

Search

GET/v1/search

Search podcasts and episodes through the catalog Elasticsearch index with type, relevance or newest ordering, and opaque search-after pagination.

Authentication

Send a server-side API key in the Authorization header. Required scope: catalog:read.

Never ship pb_live_ keys in a mobile or browser bundle. Mint short-lived listener tokens for client applications.

Request

Authorization: Bearer pb_live_your_key
Accept: application/json