# Spotify Integration via LowCodeAPI

**Last Updated**: February 10, 2026

## Overview
Music streaming

**Categories:**
- {'id': 'entertainment-media', 'name': 'Entertainment & Media'}

## Base Endpoint
https://api.lowcodeapi.com/spotify

**Important**: Always include the provider name in the URL path after `api.lowcodeapi.com/`

## Authentication
**Type:** TOKEN

**Official Documentation:** https://developer.spotify.com/documentation/web-api

## URL Format (Important)

LowCodeAPI supports two URL formats. **Always try the New Format first**, then fall back to Old Format if needed.

### New Format (Priority)
- Path parameters stay in the URL path
- Do NOT include path parameters as query parameters
- Example: `https://api.lowcodeapi.com/{provider}/resource/{id}?api_token=XXX`

### Old Format (Fallback)
- Path parameters become query parameters
- Example: `https://api.lowcodeapi.com/{provider}/resource/id?id={id}&api_token=XXX`

### Decision Flow for AI Agents
1. Always use **New Format** first - keep path parameters in the URL path
2. If you get a 404 or error, try **Old Format** with sanitized path
3. Log which format worked for future requests to this provider

## API Categories

## Common Endpoints

### Get Album

**Method:** GET
**LowCodeAPI Path:** /v1/albums/{id}

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/albums/{id}?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/albums/{id}?id={id}&api_token=YOUR_API_TOKEN

**Path Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| id | string |  |

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| market | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/spotify/v1/albums/{id}?api_token=YOUR_API_TOKEN'
```

### Get Several Albums

**Method:** GET
**LowCodeAPI Path:** /v1/albums

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/albums?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/albums?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| ids | string |  |
| market | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/spotify/v1/albums?api_token=YOUR_API_TOKEN'
```

### Get Album Tracks

**Method:** GET
**LowCodeAPI Path:** /v1/albums/{id}/tracks

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/albums/{id}/tracks?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/albums/{id}/tracks?id={id}&api_token=YOUR_API_TOKEN

**Path Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| id | string |  |

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| limit | integer |  |
| market | string |  |
| offset | integer |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/spotify/v1/albums/{id}/tracks?api_token=YOUR_API_TOKEN'
```

### Get User's Saved Albums

**Method:** GET
**LowCodeAPI Path:** /v1/me/albums

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/me/albums?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/me/albums?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| limit | integer |  |
| market | string |  |
| offset | integer |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/spotify/v1/me/albums?api_token=YOUR_API_TOKEN'
```

### Save Albums for Current User

**Method:** PUT
**LowCodeAPI Path:** /v1/me/albums

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/me/albums?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/me/albums?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| ids | string |  |

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| ids | array |  |

**Example Request (New Format):**

```bash
curl -X PUT 'https://api.lowcodeapi.com/spotify/v1/me/albums?api_token=YOUR_API_TOKEN'
```

### Remove Users' Saved Albums

**Method:** DELETE
**LowCodeAPI Path:** /v1/me/albums

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/me/albums?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/me/albums?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| ids | string |  |

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| ids | array |  |

**Example Request (New Format):**

```bash
curl -X DELETE 'https://api.lowcodeapi.com/spotify/v1/me/albums?api_token=YOUR_API_TOKEN'
```

### Check User's Saved Albums

**Method:** GET
**LowCodeAPI Path:** /v1/me/albums/contains

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/me/albums/contains?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/me/albums/contains?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| ids | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/spotify/v1/me/albums/contains?api_token=YOUR_API_TOKEN'
```

### Get New Releases

**Method:** GET
**LowCodeAPI Path:** /v1/browse/new-releases

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/browse/new-releases?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/browse/new-releases?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| country | string |  |
| limit | integer |  |
| offset | integer |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/spotify/v1/browse/new-releases?api_token=YOUR_API_TOKEN'
```

### Get Artist

**Method:** GET
**LowCodeAPI Path:** /v1/artists/{id}

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/artists/{id}?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/artists/{id}?id={id}&api_token=YOUR_API_TOKEN

**Path Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| id | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/spotify/v1/artists/{id}?api_token=YOUR_API_TOKEN'
```

### Get Several Artists

**Method:** GET
**LowCodeAPI Path:** /v1/artists

**New Format URL:**
https://api.lowcodeapi.com/spotify/v1/artists?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/spotify/artists?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| ids | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/spotify/v1/artists?api_token=YOUR_API_TOKEN'
```


## Usage Examples

### Example 1: Basic API Request (New Format)

Making a simple GET request to retrieve resources:

```bash
# Get a list of resources - no path parameters needed
curl -X GET "https://api.lowcodeapi.com/spotify/endpoint?api_token=YOUR_API_TOKEN"
```

### Example 2: Request with Path Parameters (New Format)

Retrieving a specific resource using its ID:

```bash
# Get specific resource by ID - replace RESOURCE_ID with actual ID from previous response
curl -X GET "https://api.lowcodeapi.com/spotify/endpoint/{RESOURCE_ID}?api_token=YOUR_API_TOKEN"
# Note: RESOURCE_ID typically comes from a previous list request or from the provider dashboard
```

### Example 3: POST Request with Body (New Format)

Creating a new resource:

```bash
# Create a new resource
curl -X POST "https://api.lowcodeapi.com/spotify/endpoint?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"field": "value", "another_field": "another_value"}'
```

## Error Handling

LowCodeAPI returns standard HTTP status codes. Common errors:

| Status Code | Description |
|-------------|-------------|
| 200 | Success - Request completed successfully |
| 400 | Bad Request - Invalid parameters or request body |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Endpoint or resource doesn't exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Server Error - Provider API error |

All error responses include error details:

```json
{
  "data": {
    "error": {
      "message": "Error description",
      "code": "ERROR_CODE"
    }
  }
}
```

## Complete Endpoint Reference

| Endpoint | Method | Category |
|----------|--------|----------|
| Get Album | GET | Albums |
| Get Several Albums | GET | Albums |
| Get Album Tracks | GET | Albums |
| Get User's Saved Albums | GET | Albums |
| Save Albums for Current User | PUT | Albums |
| Remove Users' Saved Albums | DELETE | Albums |
| Check User's Saved Albums | GET | Albums |
| Get New Releases | GET | Albums |
| Get Artist | GET | Artists |
| Get Several Artists | GET | Artists |
| Get Artist's Albums | GET | Artists |
| Get Artist's Top Tracks | GET | Artists |
| Get Artist's Related Artists | GET | Artists |
| Get an Audiobook | GET | Audiobooks |
| Get Several Audiobooks | GET | Audiobooks |
| Get Audiobook Chapters | GET | Audiobooks |
| Get User's Saved Audiobooks | GET | Audiobooks |
| Save Audiobooks for Current User | PUT | Audiobooks |
| Remove User's Saved Audiobooks | DELETE | Audiobooks |
| Check User's Saved Audiobooks | GET | Audiobooks |
| Get Several Browse Categories | GET | Categories |
| Get Single Browse Category | GET | Categories |
| Get a Chapter | GET | Chapters |
| Get Several Chapters | GET | Chapters |
| Get Episode | GET | Episodes |
| Get Several Episodes | GET | Episodes |
| Get User's Saved Episodes | GET | Episodes |
| Save Episodes for Current User | PUT | Episodes |
| Remove User's Saved Episodes | DELETE | Episodes |
| Check User's Saved Episodes | GET | Episodes |
| Get Available Genre Seeds | GET | Genres |
| Get Available Markets | GET | Markets |
| Get Playback State | GET | Player |
| Transfer Playback | PUT | Player |
| Get Available Devices | GET | Player |
| Get Currently Playing Track | GET | Player |
| Start/Resume Playback | PUT | Player |
| Pause Playback | PUT | Player |
| Skip To Next | POST | Player |
| Skip To Previous | POST | Player |
| Seek To Position | PUT | Player |
| Set Repeat Mode | PUT | Player |
| Set Playback Volume | PUT | Player |
| Toggle Playback Shuffle | PUT | Player |
| Get Recently Played Tracks | GET | Player |
| Get the User's Queue | GET | Player |
| Add Item to Playback Queue | POST | Player |
| Get Playlist | GET | Playlists |
| Change Playlist Details | PUT | Playlists |
| Get Playlist Items | GET | Playlists |
| Add Items to Playlist | POST | Playlists |
| Update Playlist Items | PUT | Playlists |
| Remove Playlist Items | DELETE | Playlists |
| Get Current User's Playlists | GET | Playlists |
| Get User's Playlists | GET | Playlists |
| Create Playlist | POST | Playlists |
| Get Featured Playlists | GET | Playlists |
| Get Category's Playlists | GET | Playlists |
| Get Playlist Cover Image | GET | Playlists |
| Add Custom Playlist Cover Image | PUT | Playlists |
| Search for Item | GET | Search |
| Get Show | GET | Shows |
| Get Several Shows | GET | Shows |
| Get Show Episodes | GET | Shows |
| Get User's Saved Shows | GET | Shows |
| Save Shows for Current User | PUT | Shows |
| Remove User's Saved Shows | DELETE | Shows |
| Check User's Saved Shows | GET | Shows |
| Get Track | GET | Tracks |
| Get Several Tracks | GET | Tracks |
| Get User's Saved Tracks | GET | Tracks |
| Save Tracks for Current User | PUT | Tracks |
| Remove User's Saved Tracks | DELETE | Tracks |
| Check User's Saved Tracks | GET | Tracks |
| Get Tracks' Audio Features | GET | Tracks |
| Get Track's Audio Features | GET | Tracks |
| Get Track's Audio Analysis | GET | Tracks |
| Get Recommendations | GET | Tracks |
| Get Current User's Profile | GET | Users |
| Get User's Top Items | GET | Users |
| Get User's Profile | GET | Users |
| Follow Playlist | PUT | Users |
| Unfollow Playlist | DELETE | Users |
| Get Followed Artists | GET | Users |
| Follow Artists or Users | PUT | Users |
| Unfollow Artists or Users | DELETE | Users |
| Check If User Follows Artists or Users | GET | Users |
| Check if Users Follow Playlist | GET | Users |

## API Definition Endpoints

You can fetch the complete API specification for this provider:

**New Format (OpenAPI spec):**
```bash
curl 'https://backend.lowcodeapi.com/spotify/openapi'
```

**Old Format (API definition):**
```bash
curl 'https://backend.lowcodeapi.com/spotify/definition'
```

## Response Format

All responses are wrapped in a `data` key:

```json
{
  "data": {
    // Actual response from provider (object or array)
  }
}
```