# Spinitron

**Provider:** Spinitron
**Category:** entertainment
**Base URL:** `https://spinitron.com/api`
**Auth:** api-key — `GET /playlists?access-token=YOUR_KEY`
**Rate Limit:** See documentation
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://spinitron.github.io/v2api/

## Description

Radio station management API providing access to show playlists, spin history, DJ persona information, and scheduling data for radio stations.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://spinitron.com/api/spins` | Get recent spins (songs played) |
| GET | `https://spinitron.com/api/playlists` | Get playlists for a station |
| GET | `https://spinitron.com/api/playlists/{id}` | Get a specific playlist |
| GET | `https://spinitron.com/api/shows` | Get scheduled shows |
| GET | `https://spinitron.com/api/shows/{id}` | Get a specific show |
| GET | `https://spinitron.com/api/personas` | Get DJ personas |
| GET | `https://spinitron.com/api/personas/{id}` | Get a specific DJ persona |
| POST | `https://spinitron.com/api/spins` | Log a spin |

## Authentication

API key as a query parameter (access-token)

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

## Sample Request

```bash
curl 'https://spinitron.com/api/spins?access-token=YOUR_KEY&count=5'
```

## Sample Response

```json
{"items":[{"id":1,"song":"Bohemian Rhapsody","artist":"Queen","start":"2024-01-01T20:00:00"}]}
```

## Pricing Details

Public API available free; station accounts required for write access.

---

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