CaptapiInstall

Summary

Fetches episodes for a Spotify show or podcast, with optional pagination and response caching.

Inputs

• URL (required) — Spotify show or podcast URL, URI, or ID; do not use an artist URL.
• Limit — Maximum items to return; defaults to 20 and is capped at 50. The property description lists a flat cost of 2 credits per call.
• Cursor — Pagination cursor. Leave empty for the first page, then pass the previous response’s nextCursor to fetch another page.
• Raw — When true, includes a slimmed upstream payload for each episode as episodes[].raw. visualIdentity, playedState, and podcastV2 are excluded.
• Cache — When true, serves a cached response if available; cache hits use 0 credits and include cached and cachedAt in the response envelope. Defaults to fetching fresh data.

Output shape

A response envelope containing episode data and pagination information.

The nextCursor value can be supplied as Cursor to request another page. Cache hits include cached and cachedAt; the properties do not specify the individual episode fields.

Examples

Example 1: Fetches a Spotify podcast’s episodes, with optional pagination and caching.

Provide the show’s Spotify URL, URI, or ID. Limit defaults to 20 and is capped at 50; use Cursor for later pages. Set Raw to include each episode’s slimmed upstream payload, or Cache to use a 24-hour cached response when available.

Example 2: Fetches the first page of episodes for a Spotify show.

Set URL to the show’s Spotify URL, URI, or ID. Leave Cursor empty; use the returned nextCursor to request the next page.

Example 3: Requests a cached episode response with upstream episode data.

Set URL, enable Cache, and enable Raw. Cache hits include cached and cachedAt in the response envelope, while each episode includes its slimmed upstream payload under raw.

Links

• n8n community nodes installation guide