# Spinitron v2 API

**Provider:** Spinitron v2
**Category:** developer
**Base URL:** `https://spinitron.com/api`
**Auth:** api-key — `GET /endpoint?access-token=YOUR_KEY`
**Rate Limit:** Not officially published
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://spinitron.com/api

## Description

Notes

Tutorial demo using this API is at https://spinitron.com/v2-api-demo/. For web integration using iframes and/or JavaScript instead of an API, see https://spinitron.github.io/v2-web-integration/.

*

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://spinitron.com/api/personas` | Get Personas |
| GET | `https://spinitron.com/api/personas/{id}` | Get Persona by id |
| GET | `https://spinitron.com/api/playlists` | Returns playlists optionally filtered by {start} and/or {end} datetimes |
| GET | `https://spinitron.com/api/playlists/{id}` | Get a Playlist by id |
| GET | `https://spinitron.com/api/shows` | Returns scheduled shows optionally filtered by {start} and/or {end} datetimes |
| GET | `https://spinitron.com/api/shows/{id}` | Get a Show by id |
| GET | `https://spinitron.com/api/spins` | Returns spins optionally filtered by {start} and/or {end} datetimes |
| POST | `https://spinitron.com/api/spins` | Log a Spin |

## Authentication

API key as a query parameter (access-token)

```
GET /endpoint?access-token=YOUR_KEY
```

## Sample Request

```bash
curl -X GET 'https://spinitron.com/api/personas' \
  -H 'GET /endpoint?access-token=YOUR_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Free with radio station account. Spinitron radio station playlist and chart API.

---

*Source: [API Map](https://apimap.dev/apis/spinitron-v2/) — CC BY 4.0*