This API allows external partners to send catalog metadata to the details platform, including full release, product, and track-level information. This is useful for onboarding your catalog or sending new metadata directly into the system.
What You Can Do with This API
With a single POST request, you can submit structured catalog data including:
“Labels
“Releases (title, artist, release code, release date, genres, etc.)
“Products (barcode, format, territory rights, etc.)
“Tracks (artist, title, ISRC, language, rights, metadata, credits, etc.)
Each request can contain one or more labels and their associated releases, products, and tracks.
Endpoint Details
” URL: https://openapi.berlin3.com:10000/label/json-import
” Method: POST
” Content-Type: application/json
Authentication
You need to include a valid api_key and clientID in the request body.
Example JSON Structure
{
"clientID": "yourClientID",
"api_key": "yourAPIkey",
"email": "you@example.com",
"labels": [
{
"label": "MyLabel",
"releases": [
{
"release_artist": "Various Artists",
"release_title": "Album Title",
"release_code": "ABC123",
"release_date": "2023-05-20",
"release_type": "Album",
"release_status": "Current",
"release_genre_main_1": "Electronic",
"release_genre_sub_1": "Techno",
"products": [
{
"catalog_no": "ABC123",
"barcode": "1234567890123",
"format": "Vinyl",
"product_version": "Limited Edition",
"download_yes_no": "Yes",
"streaming_yes_no": "Yes",
"excluded_countries": "",
"identfier": "ABC123-LTD",
"metadata": [
{
"metadata_set": "set1",
"metadata_name": "territory",
"data": "Europe"
}
],
"tracks": [
{
"media": 1,
"track_no": 1,
"track_artist": "DJ Test",
"track_title": "Banger One",
"version": "Original Mix",
"isrc": "DE-XYZ-25-00001",
"track_language": "English",
"p_year": "2025",
"p_text": "MyLabel",
"explicit_rights": "No",
"digital_rights": "Full",
"track_genre_main_1": "Electronic",
"track_genre_sub_1": "Techno",
"track_credits": [
{
"type": "writer",
"name": "DJ Test",
"publisher": "Test Publishing",
"share": "100"
}
],
"metadata": [
{
"metadata_set": "set2",
"metadata_name": "BPM",
"data": "128"
}
]
}
]
}
]
}
]
}
]
}
Response Codes
“200 OK Catalog data successfully ingested.
“400 Bad Request Invalid request format.
“401 Unauthorized API key or client ID incorrect.
“404 Not Found Endpoint does not exist.
” 500 Internal Server Error Server-side error.
“501 Not Implemented Feature not available.
Notes
“You can submit multiple labels and releases per request.
“Fields like track_credits, metadata, and publisher are optional but recommended for royalty tracking.
“The more complete your metadata, the better the system can match and report on your catalog.
Need Help?
If you re unsure how to prepare your data or need help with testing, please contact our support team: