music-podcast-research

Researches music, artists, playlists, and podcasts via the Crawlora API — Spotify tracks/albums/artists/playlists/profiles, Spotify Podcasts, Apple Podcasts, and Discogs — returning clean JSON. Use when the user wants a track/album/artist's details, a playlist or profile, podcast show/episode info and charts, or a record's Discogs release/pressing data.

Look up tracks, albums, artists, playlists, and podcast shows/episodes across Spotify, Spotify Podcasts, Apple Podcasts, and Discogs as normalized JSON from the Crawlora API — no scraping streaming-app pages.

When to use this skill

• "Find this track/album/artist on Spotify" / "what's on this playlist?"
• "Look up a Spotify user's public profile/playlists."
• "What podcasts/episodes are trending?" (Spotify Podcasts, Apple Podcasts charts)
• "Get details for this podcast show/episode."
• "What pressings/releases exist for this record?" (Discogs — vinyl/collector data)

Setup (one-time)

• Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
• export CRAWLORA_API_KEY=sk_your_key_here
• All requests: x-api-key: $CRAWLORA_API_KEY against https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

1. Spotify — search first: /spotify/search (or the scoped /spotify/tracks/search, /spotify/artists/search, /spotify/albums/search, /spotify/playlists/search, /spotify/profiles/search) with q. Detail endpoints (/spotify/track, /spotify/album, /spotify/artist, /spotify/playlist, /spotify/profile) accept either id or uri (a Spotify URI like spotify:track:...) — pass whichever you have. /spotify/artist/related, /spotify/track/recommended, and /spotify/track/similar-albums cover discovery.
2. Spotify Podcasts — /spotify-podcasts/search, /spotify-podcasts/show (by uri), /spotify-podcasts/show/episodes, /spotify-podcasts/charts.
3. Apple Podcasts — /apple-podcasts/search (term), /apple-podcasts/show/{id}, /apple-podcasts/show/{id}/episodes, /apple-podcasts/charts / /apple-podcasts/charts/rankings for what's popular by country.
4. Discogs — /discogs/search (q, optional type = release/master/ artist/label) to find an id, then /discogs/release/{id}, /discogs/master/{id}, /discogs/artist/{id}, /discogs/label/{id} for detail (+ /releases sub-paths for an artist's/label's catalog).

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

sh

# Spotify:
scripts/crawlora.sh /spotify/search q="Daft Punk" | jq '.'
scripts/crawlora.sh /spotify/artist id=4tZwfgrHOc3mvqYlEYSvVi | jq '.'

# Podcasts:
scripts/crawlora.sh /apple-podcasts/search term="Reply All" | jq '.'
scripts/crawlora.sh /spotify-podcasts/charts | jq '.'

# Discogs:
scripts/crawlora.sh /discogs/search q="Random Access Memories" type=release | jq '.'
scripts/crawlora.sh /discogs/release/4818226 | jq '.'

Raw curl fallback:

sh

curl -fsS -H "x-api-key: $CRAWLORA_API_KEY" \
  "https://api.crawlora.net/api/v1/spotify/search?q=lofi%20beats" | jq '.'

Endpoint reference

See reference/endpoints.md for every Spotify, Spotify Podcasts, Apple Podcasts, and Discogs endpoint this skill uses.

Examples

• Artist deep-dive: /spotify/artist + /spotify/artist/albums + /spotify/artist/related for a full discography and similar-artist map.
• Podcast discovery: /spotify-podcasts/charts or /apple-podcasts/charts to find what's trending, then /spotify-podcasts/show/episodes for a show's back catalog.
• Collector research: /discogs/search for a release, then /discogs/release/{id} for pressing details (format, year, label, condition-relevant metadata).

Notes & limits

• Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
• Public data only — public catalog/profile/chart pages.
• Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
• Spotify detail endpoints need an id or uri — resolve one via the matching .../search endpoint first if you only have a name.
• Search endpoints are paginated (limit/offset or page) — walk pages for full coverage.