Pre-release demo

Interactive API Explorer

Explore our API endpoints interactively. Try out API methods with custom parameters, view responses, and get familiar with the capabilities of the BeatConnect API.

GET /api/v1/beats

List Beats

Returns a paginated list of beats with optional filtering by genre, price range, and other attributes.

Authentication

Query Parameters

string optional
string optional
integer optional
integer optional
https://api.beatconnectafrica.com/v1/beats

Response

200 OK 178ms
{
  "success": true,
  "data": [
    {
      "id": 1,
      "title": "Amapiano Summer",
      "producer": "KayzBeatz",
      "price": 29.99,
      "genre": {
        "id": 3,
        "name": "Amapiano",
        "slug": "amapiano"
      },
      "bpm": 110,
      "key": "C minor",
      "length": "3:24",
      "cover_image": "https://api.beatconnectafrica.com/images/covers/beat1.jpg",
      "audio_preview": "https://api.beatconnectafrica.com/audio/previews/beat1.mp3",
      "created_at": "2024-04-12T14:30:00Z"
    },
    {
      "id": 2,
      "title": "Lagos Nights",
      "producer": "AfroRhythm",
      "price": 34.99,
      "genre": {
        "id": 5,
        "name": "Afrobeats",
        "slug": "afrobeats"
      },
      "bpm": 105,
      "key": "G major",
      "length": "3:42",
      "cover_image": "https://api.beatconnectafrica.com/images/covers/beat2.jpg",
      "audio_preview": "https://api.beatconnectafrica.com/audio/previews/beat2.mp3",
      "created_at": "2024-04-10T09:15:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 231
  }
}

Code Samples

bash
curl -X GET "https://api.beatconnectafrica.com/v1/beats?genre=amapiano&sort=newest&page=1&limit=20" \
    -H "Accept: application/json"