Skip to content

Spotify

Emulated Spotify Web API for local development and testing.

Models the canonical OAuth 2.0 client credentials provider: an app-only token (no user) minted from a client_id/client_secret, reaching the public catalog.

Included now:

POST /api/token (client credentials; form body or HTTP Basic)
GET /v1/search with q and type=artist,album,track
GET /v1/artists/:id, /v1/artists/:id/albums, /v1/albums/:id, /v1/tracks/:id
OpenAPI subset at /openapi.json

Start

# From this repo (after `bun install && bun run build`)
bun packages/emulate/dist/index.js --service spotify

# Or from the published package
npx @pleaseai/emulate --service spotify

A single service starts on the base port (default 4000). Use -p <port> to change it. When started alongside other services, ports are assigned sequentially from the base port.

Auth

curl -X POST http://localhost:4000/api/token \
  -d grant_type=client_credentials \
  -d client_id=spotify_client_id_example \
  -d client_secret=spotify_client_secret_example

Catalog Example

curl "http://localhost:4000/v1/search?q=daft&type=artist" \
  -H "Authorization: Bearer <access_token>"

Seed Config

Add a spotify: section to emulate.config.yaml (or pass --seed <file>):

spotify:
  clients:
    - client_id: spotify_client_id_example
      client_secret: spotify_client_secret_example
      name: Demo App
  artists:
    - name: Daft Punk
      genres: [electronic]
      albums:
        - name: Discovery
          release_date: 2001-03-12
          tracks:
            - name: One More Time