ACRCloud
Search…
Broadcast Database Projects
post
https://api-v2.acrcloud.com
/api/bm-bd-projects
Create a project
Curl
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-bd-projects' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \
--header 'Content-Type: application/json' \
--data-raw '{"region": "eu-west-1", "name": "test1", "buckets": [14661]}'
put
https://api-v2.acrcloud.com
/api/bm-bd-projects/:id
Update a project
Curl
curl --location --request PUT 'https://api-v2.acrcloud.com/api/bm-bd-projects/12345' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \
--header 'Content-Type: application/json' \
--data-raw '{"region": "eu-west-1", "name": "test2", "buckets": [14661, 23]}'
delete
https://api-v2.acrcloud.com
/api/bm-bd-projects/:id
Delete a project
Curl
curl --location --request DELETE 'https://api-v2.acrcloud.com/api/bm-bd-projects/12345' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \
get
https://api-v2.acrcloud.com
/api/bm-bd-projects
List the projects
CURL
curl --location --request GET 'https://api-v2.acrcloud.com/api/bm-bd-projects?region=eu-west-1&page=1&per_page=20' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \
post
https://api-v2.acrcloud.com
/api/bm-bd-projects/:id/result-callback
Set results callback URL
Curl
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-bd-projects/12345/result-callback?type=diy' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your token}' \
--data-raw '{"result_callback_url": "http://*****", "result_callback_send_noresult": false, "result_callback_send_type": "2", "result_callback_result_type": "1"}'
The following is the example of the results of the monitoring system posting to your results callback URL
Sample result of Music(Callback)
Sample result of Custom Files(Callback)
{
"stream_id": "100251",
"stream_name": "BBC Radio 1",
"stream_country": "United Kingdom",
"bucket_id": "23",
"status": 1,
"user_defined": {
"custom_id": "test_id"
},
"data": {
"status": {
"msg": "Success",
"version": "1.0",
"code": 0
},
"result_type": 0,
"metadata": {
"type": "delay",
"timestamp_utc": "2020-01-14 05:49:18",
"played_duration": 139,
"music": [
{
"album": {
"name": "I Know You"
},
"play_offset_ms": 19800,
"genres": [
{
"name": "Dance"
}
],
"contributors": {
"composers": [
"Craig David",
"Dan Smith",
"Fraser T Smith",
"Helen Culver"
],
"lyricists": [
"DANIEL CAMPBELL SMITH",
"FRASER LANCE THORNEYCROFT SMITH",
"CARMEN REECE",
"CRAIG ASHLEY DAVID"
]
},
"lyrics": {
"copyrights": [
"Universal Music Publishing Group"
]
},
"title": "I Know You",
"result_from": 3,
"release_date": "2017-11-10",
"sample_end_time_offset_ms": 9180,
"sample_begin_time_offset_ms": 3520,
"label": "Speakerbox/Insanity Records",
"duration_ms": 214760,
"score": 100,
"db_begin_time_offset_ms": 13860,
"artists": [
{
"name": "Craig David"
}
],
"db_end_time_offset_ms": 19520,
"external_ids": {
"isrc": [
"GBARL1701677",
"GBARL1800085"
],
"upc": [
"886446809496",
"886446747439",
"886446617541"
]
},
"acrid": "9564199dacc709123aee61c9556bacd2",
"external_metadata": {
"spotify": [
{
"track": {
"name": "I Know You",
"id": "34t13rSSZtr22CjcmroMmh"
},
"album": {
"name": "I Know You",
"id": "1SaIescHHJvcb0oyGVVIme"
},
"artists": [
{
"name": "Craig David",
"id": "2JyWXPbkqI5ZJa3gwqVa0c"
},
{
"name": "Bastille",
"id": "7EQ0qTo7fWT7DPxmxtSYEc"
}
]
},
{
"track": {
"name": "I Know You",
"id": "5lRzEC0Hyj92nEr9JkDxM2"
},
"album": {
"name": "The Time Is Now (Deluxe)",
"id": "51vRvV83RdWGP9FpzGe4SQ"
},
"artists": [
{
"name": "Craig David",
"id": "2JyWXPbkqI5ZJa3gwqVa0c"
},
{
"name": "Bastille",
"id": "7EQ0qTo7fWT7DPxmxtSYEc"
}
]
}
],
"deezer": [
{
"track": {
"name": "I Know You",
"id": "419827392"
},
"album": {
"name": "I Know You",
"id": "50234022"
},
"artists": [
{
"name": "Craig David",
"id": 110
},
{
"name": "Craig David",
"id": 110
},
{
"name": "Bastille",
"id": 1352097
}
]
},
{
"track": {
"name": "I Know You",
"id": "450179142"
},
"album": {
"name": "The Time Is Now (Deluxe)",
"id": "55045462"
},
"artists": [
{
"name": "Craig David",
"id": "110"
}
]
},
{
"track": {
"name": "I Know You",
"id": "478445942"
},
"album": {
"id": "59933892"
},
"artists": [
{
"id": 110,
"name": "Craig David"
},
{
"id": 1352097,
"name": "Bastille"
}
]
}
]
}
}
],
"record_timestamp": "20200114054918"
}
}
}
{
"stream_id": "100251",
"stream_name": "BBC Radio 1",
"stream_country": "United Kingdom",
"bucket_id": "23",
"status": 1,
"user_defined": {
"custom_id": "test_id"
},
"data": {
"status": {
"msg": "Success",
"code": 0,
"version": "1.0"
},
"metadata": {
"timestamp_utc": "2015-07-27 12:56:46",
"played_duration": 30,
"custom_files": [
{
"bucket_id": "51",
"title": "You are beautiful",
"artist": "James",
"acrid": "5343bc191634b042622bf474ed46121a",
"audio_id": "3",
}
]
},
"result_type": 0
}
}
post
https://api-v2.acrcloud.com
/api/bm-bd-projects/:id/state-notification
Set state notification callback
Curl
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-bd-projects/12345/state-notification' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your token}' \
--data-raw '{"state_callback_url": "http://www.xxxx.com/state_callback", "state_callback_type": "2"}'

Example of monitoring system sending state data to your callback URL

{
"status":[
{
"stream_name":"Radio Fermo Uno",
"code":6,
"timestamp":"2022-01-22 14:02:00",
"stream_id":"222195",
"state":"invalid_url",
"type":"unknown"
}
]
}

The details of the state code

Code
State Name
0
Running
1
Timeout
4
Paused
6
Invaild URL
10
Deleted
12
Mute