Visit WebsiteConsole

User Reports

Insert user results

POST https://api-v2.acrcloud.com/api/bm-cs-projects/:pid/streams/:stream_id/user-reports

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

Path Parameters

Name
Type
Description

pid

number

The project id

stream_id

string

The stream 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

string

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)

reuslt.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

string

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

{
  "data": {
    "id": 984590,
    "result": {
      "start_timestamp_utc": "2021-05-25 03:55:49",
      "end_timestamp_utc": "2021-05-25 03:56:37",
      "record_timestamp": "",
      "title": "xxx",
      "artists": "xxx",
      "album": "xxx",
      "acrid": "null",
      "duration": 48,
      "played_duration": 48,
      "monitor_type": "",
      "result_type": "custom",
      "from": "api-report",
      "raw_metadata": {
        "title": "xxx",
        "artist": "xxx",
        "album": "xxx"
      },
      "start_timestamp_local": "2021-05-25 11:55:49",
      "end_timestamp_local": "2021-05-25 11:56:37"
    }
  }
}
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-cs-projects/17913/stream_id/s-XXXXXX/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