Reference

API reference

Every endpoint in the PodAnalyst Analytics API — authentication, parameters, and a copy-paste example for each.

What this covers

Every endpoint in the PodAnalyst Analytics API, served under /v2/analytics. All of them return JSON.

Authentication

Send your API key in an x-api-token header on every request:

curl -H "x-api-token: $PODANALYST_API_KEY" "https://app.podanalyst.com/v2/analytics/podcasts"

Get your key from inside the app: open your avatar menu (top right) → API Key → Copy. If you connect through the MCP connection instead, use the token shown there in an x-mcp-token header.

Treat the key like a password — anyone who has it can read your data. Regenerate key in that same dialog immediately invalidates the old one.

The ids you pass

placeholder	where to get it
`{podcastId}`	The show's Apple Podcasts id — the `itunes_id` from `GET /v2/analytics/podcasts`.
`{episodeId}`	The episode's `id` from `GET /v2/analytics/podcast/{podcastId}/episodes`.
`{keywordId}`	The keyword's `id` from `GET /v2/analytics/podcast/{podcastId}/tracked-keywords`.

Shows and episodes

Tracked Podcasts

GET /v2/analytics/podcasts

Lists the shows the authenticated user's company tracks.

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcasts"

Podcast Trends

GET /v2/analytics/podcast/{podcastId}/trends

Metric time series for a show grouped by platform.

parameter	example	notes
`mode`	`all_time`	all_time \| past_sixty_days \| monthly
`metric`	`unique_listeners`	unique_listeners \| followers \| plays \| seconds_consumed
`startDate`	`—`	Required when mode=monthly. Must be omitted for all_time/past_sixty_days.
`platform`	`—`	apple \| spotify. Empty = both.

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/trends?mode=all_time&metric=unique_listeners"

Episode Trends

GET /v2/analytics/podcast/{podcastId}/episode/{episodeId}/trends

Episode metric time series grouped by platform.

parameter	example	notes
`mode`	`all_time`
`metric`	`unique_listeners`
`startDate`	`—`	Required when mode=monthly.
`platform`	`—`	apple \| spotify

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/episode/{episodeId}/trends?mode=all_time&metric=unique_listeners"

Podcast Episodes

GET /v2/analytics/podcast/{podcastId}/episodes

Recent episodes of a show, newest first.

parameter	example	notes
`limit`	`10`	Max rows. Default 1.

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/episodes?limit=10"

Episode Detail

GET /v2/analytics/podcast/{podcastId}/episode/{episodeId}

Episode detail plus per-platform second-by-second retention.

parameter	example	notes
`platform`	`—`	both (default) \| apple \| spotify

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/episode/{episodeId}"

Keywords

Keyword Search

GET /v2/analytics/keyword

Searches the Apple Podcasts catalog.

parameter	example	notes
`q`	`news`	Minimum 2 characters.

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/keyword?q=news"

Tracked Keywords

GET /v2/analytics/podcast/{podcastId}/tracked-keywords

Keywords currently tracked for a show.

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/tracked-keywords"

Track Keyword

POST /v2/analytics/podcast/{podcastId}/tracked-keyword

Adds a keyword to track for a show.

curl -X POST \
  -H "x-api-token: $PODANALYST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"climate"}' \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/tracked-keyword"

Untrack Keyword

DELETE /v2/analytics/podcast/{podcastId}/tracked-keyword/{keywordId}

Untracks a keyword from a show.

curl -X DELETE \
  -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/tracked-keyword/{keywordId}"

Reviews

Podcast Reviews

GET /v2/analytics/podcast/{podcastId}/reviews

Recent reviews of a show, newest first.

parameter	example	notes
`limit`	`10`	Max rows. Default 1.

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/reviews?limit=10"

Charts

Chart History

GET /v2/analytics/podcast/{podcastId}/chart-history

Historic chart rank for a show within a country + category chart.

parameter	example	notes
`country`	`US`	Required. Lowercased before the DB query.
`category`	`1324`	Required. Genre name (e.g. "Society & Culture") or numeric id (26 All, 1489 News, 1324 Society & Culture). Resolved to the numeric id.

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/chart-history?country=US&category=1324"

Chart Shows

GET /v2/analytics/podcast/{podcastId}/chart-shows

Shows currently ranked in the most-recent chart snapshot for a country + category.

parameter	example	notes
`country`	`US`	Required. Lowercased before the DB query.
`category`	`1324`	Required. Genre name (e.g. "Society & Culture") or numeric id (26 All, 1489 News, 1324 Society & Culture). Resolved to the numeric id.

curl -H "x-api-token: $PODANALYST_API_KEY" \
  "https://app.podanalyst.com/v2/analytics/podcast/{podcastId}/chart-shows?country=US&category=1324"