Skip to content

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

List artists in catalogue

Request

Returns a paginated list of artists available in the Audicin catalogue.

Supports optional filtering by artist first name and/or last name. This endpoint is commonly used for catalogue browsing, search, and artist discovery features.

Security
api-key
Query
pageinteger(int32)[ 0 .. 100 ]
Default 0
sizeinteger(int32)[ 1 .. 100 ]
Default 10
artistFirstNamestring
artistLastNamestring
curl -i -X GET \
  'https://dev.api-b2b.audicin.com/api/v1/tenants/artists?page=0&size=10&artistFirstName=string&artistLastName=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
}

Fetch artist details

Request

Returns detailed information about a specific artist available in the Audicin catalogue.

This endpoint is typically used to display artist profile pages, artist credits, or contextual information linked from songs.

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

Responses

OK

Bodyapplication/json
idstring

Artist ULID

firstNamestring

First name

lastNamestring

Last name

descriptionstring

Artist bio/description

avatarobject(MediaTenantResponse)

Media asset (audio, image) metadata and URL

Response
application/json
{
  "id": "01HXZK9YF8A1B3C4D5E6F7G8H",
  "firstName": "Jane",
  "lastName": "Artist",
  "description": "Artist bio",
  "avatar": null
}

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

Media

Fetch media data

Operations