Visit WebsiteConsole

User Reports

Insert user results

POST https://api-v2.acrcloud.com/api/bm-bd-projects/:pid/channels/:channel_id/user-reports

This endpoint allows you to insert the results just like in Timemap or UCF

Path Parameters

Name
Type
Description

pid

string

The project id

channel_id

string

The channel id

Headers

Name
Type
Description

Accept

string

application/json

Authorization

string

Bearer token

Content-Type

string

application/json

Request Body

Name
Type
Description

data

array

Result list ([result1, result2, result3...])

result.from

string

api

result.title

string

The title of the result

result.timeoffset

number

UTC time offsets (For example, UK time is UTC + 00:00, the timeoffset is 0; Hong Kong time is UTC + 08:00, the timeoffset is -480)

result.start_timestamp

string

YYYY-mm-dd HH:MM:SS (For example, 2021-02-01 12:13:14), it is your Local Time.

result.end_timestamp

string

YYYY-mm-dd HH:MM:SS (For example, 2021-02-01 12:15:26), it is your Local Time.

result.user_defined

object

Other fields of the result (For example, {"artists": "xxx", "album": "xxx", "isrc": "xxx"})

{
  "data": {
    "id": 984587,
    "result": {
      "start_timestamp_utc": "2021-05-25 02:35:42",
      "end_timestamp_utc": "2021-05-25 02:36:25",
      "title": "xxx",
      "artist": "",
      "album": "",
      "acrid": "null",
      "duration": 43,
      "played_duration": 43,
      "monitor_type": "",
      "result_type": "custom",
      "from": "api-report",
      "raw_metadata": {
        "title": "xxx",
        "artists": "xxx",
        "album": "xxx"
      },
      "start_timestamp_local": "2021-05-25 10:35:42",
      "end_timestamp_local": "2021-05-25 10:36:25"
    }
  }
}
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-bd-projects/179/channels/100251/user-reports' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}'
--header 'Content-Type: application/json' \
--data-raw '{"data":[{"from": "api", "title": "xxxx", "timeoffset": 0, "start_timestamp": "2021-02-01 12:13:14", "end_timestamp": "2021-02-01 12:15:26", "user_defined": {"artists": "xxx", "album": "xxx"}}]}'

Last updated