music-podcast-research

stars:0
forks:1
watches:0
last updated:2026-08-10 07:51:26

Music & podcast research

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

# 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:

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.
Good AI Tools