🎷 Jazz Reference API

Complete API documentation for the Jazz Reference platform

Welcome to the Jazz Reference API

The Jazz Reference API provides programmatic access to a comprehensive database of jazz songs, recordings, performers, and related metadata. This RESTful API enables developers to build applications that leverage our curated jazz music knowledge base.

🚀 Quick Start

Base URL: https://www.linernotesjazz.com

Try your first request:

curl https://www.linernotesjazz.com/api/songs

API Capabilities

🎵 Songs

Access detailed information about jazz compositions, including composers, structures, and external references.

  • Search and filter songs
  • Get detailed song information
  • View all recordings of a song
  • Access composer information

💿 Recordings

Explore specific recordings with album details, performers, and external streaming links.

  • Browse all recordings
  • Get recording details with performer lineups
  • Access Spotify and YouTube links
  • Filter canonical recordings

🎺 Performers

Discover jazz artists and their contributions across recordings.

  • Search performers by name
  • View performer biographies
  • See complete discographies
  • Access performer images and photos

🖼️ Images

Access artist photos and images with proper licensing and attribution.

  • Get performer images
  • View image metadata and sources
  • Access licensing information
  • Support for thumbnails and full-size images

Key Features

RESTful Design

Standard HTTP methods (GET) with intuitive endpoint structure and JSON responses.

No Authentication Required

All endpoints are publicly accessible. No API keys or authentication needed.

Search & Filter

Most endpoints support search parameters to help you find exactly what you need.

Rich Metadata

Comprehensive information including external references, timestamps, and relationships.

Response Format

All API responses are returned in JSON format. Here's a typical response structure:

JSON 
{
  "id": 1,
  "title": "Take Five",
  "composer": "Paul Desmond",
  "structure": "AABA",
  "external_references": {
    "wikipedia": "https://en.wikipedia.org/wiki/Take_Five",
    "musicbrainz": "abc123"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Error Handling

When errors occur, the API returns appropriate HTTP status codes with descriptive error messages:

JSON 
{
  "error": "Failed to fetch data",
  "detail": "Database connection timeout"
}

Common Status Codes

Status Code Meaning Description
200 OK Request successful
404 Not Found Resource doesn't exist
500 Internal Server Error Server-side error occurred
503 Service Unavailable Service temporarily unavailable

Rate Limiting

Fair Use Policy

While there are currently no strict rate limits, please use the API responsibly. Excessive requests may be throttled to ensure service availability for all users.

Getting Started

  1. Browse the API Reference to see all available endpoints
  2. Check out the Examples page for common use cases
  3. Start making requests to https://www.linernotesjazz.com/api/
  4. Build something amazing! 🎵