Skip to content
/
Get song details from cat...

Audicin for Apps API (1.0.0)

Audicin for Apps API Authentication (REQUIRED)

All Audicin for Apps API endpoints require the X-API-KEY header.

Example:

X-API-KEY: xxxxxxxxx

Common error responses:

  • 401 → Missing or invalid API key
  • 402 → Subscription inactive / expired
  • 403 → License missing or quota exceeded
  • 404 → Resource not found
Download OpenAPI description
b2b_portal_documentation.json
b2b_portal_documentation.yaml
Overview
URL
https://audicin.com
TEAM
developers@audicin.com
License
Proprietary License
Terms of Service
Languages
Servers
Generated server url
https://dev.api-b2b.audicin.com/api/v1

Artists

Fetch artist metadata

Operations

Licenses

Fetch license data

Operations

Categories

Fetch category data

Operations

Streaming

Generate presigned URLs for audio previews and full audios

Operations

Songs

Fetch song data and metadata

Operations

List available songs in catalogue

Request

Returns a paginated list of songs from the Audicin catalogue that are visible to the authenticated tenant. Supports filtering by title and genre. Song availability does not imply licensing or streaming rights.

Security
api-key
Query
pageinteger(int32)[ 0 .. 100 ]
Default 0
sizeinteger(int32)[ 1 .. 100 ]
Default 10
titlestring
mainGenrestring
secondaryGenrestring
curl -i -X GET \
  'https://dev.api-b2b.audicin.com/api/v1/tenants/songs?page=0&size=10&title=string&mainGenre=string&secondaryGenre=string' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

Paginated list of artists

Bodyapplication/json
contentArray of objects(ArtistTenantResponse)

Page content

numberinteger(int32)
Example: 0
sizeinteger(int32)
Example: 10
totalElementsinteger(int64)
Example: 42
totalPagesinteger(int32)
Example: 5
Response
application/json
{
  "content": [],
  "number": 0,
  "size": 10,
  "totalElements": 0,
  "totalPages": 0
}

Get song details from catalogue

Request

Fetches detailed metadata for a single song available in the Audicin catalogue for the authenticated tenant. This endpoint does not grant a license or streaming access; it only returns song information.

Security
api-key
Path
songIdstringrequired
curl -i -X GET \
  'https://dev.api-b2b.audicin.com/api/v1/tenants/songs/{songId}' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
idstring

Song ULID

titlestring

Song title

mainArtistobject(ArtistTenantResponse)

Artist details as returned to the developer portal

secondsinteger(int32)

Duration in seconds

previewAudioobject(MediaTenantResponse)

Media asset (audio, image) metadata and URL

coverMediaobject(MediaTenantResponse)

Media asset (audio, image) metadata and URL

descriptionstring

Song description

categoriesArray of objects(CategoryTenantResponse)

Categories/genres

artistsArray of objects(ArtistTenantResponse)

All contributing artists

Response
application/json
{
  "id": "01HXZK9YF8A1B3C4D5E6F7G8H",
  "title": "Example Song",
  "mainArtist": {
    "id": "01HXZK9YF8A1B3C4D5E6F7G8H0",
    "firstName": "Jane",
    "lastName": "Artist",
    "description": "Artist bio",
    "avatar": null
  },
  "seconds": 180,
  "previewAudio": null,
  "coverMedia": null,
  "description": "Song description",
  "categories": [],
  "artists": []
}

Media

Fetch media data

Operations