🔍 Referencia API

/search

GET

Busca tracks, álbumes, artistas o playlists.

• q (string) – término de búsqueda
• type (string) – track,album,artist,playlist
• limit (int) – max 50 (default 20)
• offset (int) – paginación

curl -H "Authorization: Bearer {token}" \
https://api.spotify.com/v1/search?q=synthwave&type=track&limit=10

/stations/bycountry

GET

Lista de emisoras por país (Radio Browser).

• country (string) – nombre en inglés
• limit (int) – max 100
• offset (int) – paginación

curl https://de1.api.radio-browser.info/json/stations/bycountry/Spain?limit=5

/events

GET

Eventos próximos de un artista (Songkick).

• artist_id (int) – ID de Songkick
• apikey (string) – tu clave

curl https://api.songkick.com/api/3.0/artists/123/events.json?apikey={key}

Best Practices & Rate-Limits

• Cachea respuestas 1-5 min para reducir llamadas.
• Usa ETag y If-None-Match para evitar re-downloads.
• Respeta headers X-RateLimit-Remaining y X-RateLimit-Reset.
• Retries exponenciales ante errores 5xx.
• Nunca expongas tu Client Secret en frontend.