SOUND.RADAR API DEV
HOME Docs

Artists API

DJ Radar

Global DJ rankings — 22,931 DJs with rank, country, genre, profile images, bios and full discography (albums and tracks).

Overview

What this API is for

This API exposes a global DJ ranking catalog. Each DJ record carries rank, country, genre, profile images and logo, an embedded Spotify playlist, and short/wiki/long biographies. DJs with a linked Spotify catalog also expose a full discography of albums, singles and tracks. Matched DJs additionally carry booking/management contacts (agents, managers, publicists), per-platform social followers, and reach insights. Use it to power artist directories, ranking widgets, DJ profile pages, booking research, and discovery.

Contacts note: contact records exist for a subset of DJs (top-ranked). Email/phone and some aggregate insights (total reach, engagement, Spotify listeners) are partially available; representative names, roles, territory, area, and per-platform follower counts are complete.

Access

Public path and credentials

Basehttps://api.soundradar.co/djrankings
AuthProtected data endpoints require X-API-Key. Keep keys server-side.
SchemaOpenAPI JSON and Swagger UI are available.

Endpoints

Available routes

GET/djrankings/health

Public service health and total DJ count.

GET/djrankings/djs

Paginated DJ list with search and filters. Requires X-API-Key.

qcountrygenrehas_discographyhas_contactspageper_pagesort
GET/djrankings/djs/{slug}

Full DJ profile including brief, wiki, bio, the complete albums and tracks arrays, and a contact block (agents/managers/publicists, social followers, insights) when available.

GET/djrankings/djs/{slug}/contacts

Booking/management contacts for one DJ: representative names, roles, territory, area, address, (masked) email/phone, per-platform social followers, and reach/Spotify insights.

GET/djrankings/djs/{slug}/albums

Albums and singles for one DJ (title, type, release date, track count, Spotify).

GET/djrankings/djs/{slug}/tracks

Tracks for one DJ (title, album, popularity, duration, Spotify).

GET/djrankings/countries

DJ counts grouped by country, sorted descending. Requires X-API-Key.

GET/djrankings/stats

Dataset totals: DJs, DJs with detail, DJs with discography, albums, tracks, countries.

Examples

Requests

curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/djrankings/djs?per_page=10"
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/djrankings/djs?country=Netherlands&genre=Techno"
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/djrankings/djs/DAVID_GUETTA"
# booking/management contacts only
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/djrankings/djs/DAVID_GUETTA/contacts"
# only DJs that have contact records
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/djrankings/djs?has_contacts=true"

Operations

Runtime notes

Image fields (flag, thumb, image, logo) are returned as absolute URLs. The catalog is a periodic snapshot refreshed by the DJ ranking crawler behind the public /djrankings contract.