Broadcast Database Projects

Search…
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
User Reports
Channels
Last modified 1mo ago
Copy link
Outline
Set results callback URL
post
Set state notification callback