Skip to content

Flagging Clips ​

POST /flag_clip

Reports a clip that does not play, shows the wrong part of the game, or is wrong in another way. Each flag notifies the CTG team to look into it.

Request ​

Send JSON with the same values you passed to /clip, plus a description of the problem:

FieldRequiredTypeDescription
game_id_nbaOne of these twostringNBA game ID, as in the data feed
game_idOne of these twoUUIDVideo game ID. See Game IDs
periodYesintegerPeriod number
start_game_clockOne of these twonumberSeconds left in the period
start_timestampOne of these twointegerWall clock time in epoch milliseconds
start_paddingNointegerSeconds before the start time
end_paddingNointegerSeconds after the start time
feedbackYesstringWhat is wrong with the clip
bash
curl --request POST \
  --url 'https://api.cleaningtheglass.com/video/flag_clip' \
  --header 'X-API-KEY: YOUR_VIDEO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "game_id": "00124539-08e3-4174-bd7f-db5e96a904fb",
    "period": 1,
    "start_game_clock": 720,
    "start_padding": 3,
    "end_padding": 3,
    "feedback": "Expected the start of the period, but the clip starts a few seconds in"
  }'

Response ​

200 with {"result": "Success"}, 400 with {"result": "Error"} when a required field is missing, or 404 when game_id_nba has no video.

To report a problem with the Video API itself, use the feedback form.