---
title: "Send video beacon data"
method: POST
path: "/beacon-video"
tags: ["Analytics API"]
---

# Send video beacon data

`POST /beacon-video`

## Request

- Base URL: `https://data.pandavideo.com`
- URL: `https://data.pandavideo.com/beacon-video`
- Auth: none declared

Receives and processes video tracking beacon data from video players.

**Note**: This endpoint is primarily used for internal processing of video analytics data.
The data is processed and stored for analytics purposes.

## Request body

- VideoBeaconData
  - `video_id` string, uuid, required: Video identifier
  - `user_id` string, required: User identifier
  - `event_type` 'play' | 'view' | 'check', required: Type of video event
  - `timestamp` integer, required: Unix timestamp in milliseconds
  - `current_time` integer: Current playback time in seconds
  - `duration` integer: Total video duration in seconds
  - `pullzone_name` string: CDN pullzone name
  - `start_time` integer: Start time for time range (used with end_time)
  - `end_time` integer: End time for time range (used with start_time)

## Response `200`

Beacon data processed successfully

- object
  - `message` string

## Other responses

- `400`: Bad request - Invalid input parameters
- `500`: Internal server error

---

[API](https://skmtc.dev/pandavideo/apis/panda-analytics-video-api-2.md) - [All operations](https://skmtc.dev/pandavideo/apis/panda-analytics-video-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/pandavideo/apis/panda-analytics-video-api-2/revisions/b91a08a16590?raw)