# Lyrics API
> Fetch full song lyrics by artist and title, and search across millions of songs to find the right track. Returns the lyrics as text and as an array of lines, ready to display or process.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/lyrics-api/..."
```

## Pricing
- **Free** (Free) — 750 calls/Mo, 2 req/s
- **Basic** ($7/Mo) — 40,000 calls/Mo, 8 req/s
- **Pro** ($22/Mo) — 200,000 calls/Mo, 25 req/s
- **Mega** ($69/Mo) — 1,200,000 calls/Mo, 80 req/s

## Endpoints

### Lyrics

#### `GET /v1/lyrics` — Lyrics for an artist + title

**Parameters:**
- `artist` (query, required, string) — Artist name Example: `Coldplay`
- `title` (query, required, string) — Song title Example: `Yellow`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lyrics-api/v1/lyrics?artist=Coldplay&title=Yellow"
```

**Response:**
```json
{
    "data": {
        "lines": [
            "Look at the stars",
            "look how they shine for you",
            "and everything you do",
            "yeah they were all yellow",
            "I came along",
            "I wrote a song for you",
            "and all the things you do",
            "and it was called yellow",
            "So then I took my turn",
            "oh what a thing to have done",
            "and it was all yellow",
            "",
            "your skin",
            "oh yeah your skin and bones",
            "turn into something beautiful",
            "and you know",
            "you know I love you so",
            "you know I love you so",
            "",
            "I swam across",
            "I jumped across for you",
            "oh what a thing to do",
            "'cos you were all yellow",
            "I drew a line",
            "I drew a line for you",
            "oh what a thing to do",
            "and it was all yellow",
            "",
            "and your skin",
            "oh yeah your skin and bones",
            "turn into something beautiful",
            "and you know",
            "for you I bleed myself dry",
            "for you I bleed myself dry",
            "",
            "it's true",
            "look how they shine for you",
            "look how they shine for you",
            "look how they shine for",
            "look how they shine for you",
            "look how they shine for you",
            "l
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search songs (find artist + title)

**Parameters:**
- `q` (query, required, string) — Search term Example: `bohemian rhapsody`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lyrics-api/v1/search?q=bohemian+rhapsody"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "bohemian rhapsody",
        "results": [
            {
                "album": "A Night At The Opera (2011 Remaster)",
                "cover": "http://cdn-images.dzcdn.net/images/cover/6706f1154083f461a348508c28030a30/250x250-000000-80-0-0.jpg",
                "title": "Bohemian Rhapsody (Remastered 2011)",
                "artist": "Queen",
                "preview": "http://cdnt-preview.dzcdn.net/api/1/1/e/3/9/0/e395ad329758f01e5787f03e5286636f.mp3?hdnea=exp=1780100928~acl=/api/1/1/e/3/9/0/e395ad329758f01e5787f03e5286636f.mp3*~data=user_id=0,application_id=42~hmac=6d7d35add3ef1fb8fb5acc9504e2df8524cd955a6f4917370f7e89b01e8ba74e"
            },
            {
                "album": "Bohemian Rhapsody (The Original Soundtrack)",
                "cover": "http://cdn-images.dzcdn.net/images/cover/8b8fc5d117f9357b79f0a0a410a170e8/250x250-000000-80-0-0.jpg",
                "title": "Bohemian Rhapsody (Live Aid)",
                "artist": "Queen",
                "preview": "http://cdnt-preview.dzcdn.net/api/1/1/c/9/3/0/c93393b8a00a8489617f00819b2a81da.mp3?hdnea=exp=1780100928~acl=/api/1/1/c/9/3/0/c93393b8a00a8489617f00819b2a81da.mp3*~data=user_id=0,application_id=42~hmac=973cd84dc5189a34a5a4a4934307df9af79a4d47bb8299ab64a10609c8c166b9"
            },
            {
                "album": "Live At Wembley Stadium",
                "cover": "http://cdn-images.dzcdn.net/images/cover/90192223423fbfa45bbf4ef9f68cf9f7/250x25
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/lyrics-api
OpenAPI spec: https://www.oanor.com/api/lyrics-api/openapi.json