developers

OSTDB Public API

Free access to video game soundtrack data. Query by IGDB ID, get streaming links for Spotify and Apple Music. Rate limited to 100 requests per minute.

How it works

Get your API keys

Fill in the form below to instantly generate your Client ID and Client Secret.

Exchange for a token

Send your credentials to get a Bearer token. Tokens last up to 7 days — request a new one when expired.

Query the API

Use the token to fetch soundtrack data for any game by IGDB ID.

Step 1 — Get a token

Send your client_id and client_secret to receive a Bearer token. Add expires_in (seconds) to set token lifetime — default 1 hour, max 7 days (604800). Need longer? api@ostdb.net

POST https://data.ostdb.net/v1/oauth/token
Content-Type: application/json

{
  "client_id": "your-client-id",
  "client_secret": "your-client-secret",
  "expires_in": 604800
}

Response:

{
  "access_token": "eyJ...",
  "token_type": "bearer",
  "expires_in": 604800
}

Step 2 — Fetch soundtracks

Use the token from Step 1 in the Authorization header. Replace {igdb_id} with any IGDB game ID.

GET https://data.ostdb.net/v1/ost/{igdb_id}
Authorization: Bearer eyJ...

Response:

{
  "igdb_id": 134,
  "game_name": "Half-Life",
  "soundtracks": [
    {
      "id": "uuid",
      "album_name": "Half-Life Soundtrack",
      "cover_url": "https://...",
      "streaming": {
        "spotify": "https://open.spotify.com/...",
        "apple_music": null,
        "album_link": null
      }
    }
  ]
}

Get API Keys

Free, instant. No waiting.