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

# Send live beacon data

`POST /beacon-live`

## Request

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

Receives and processes live streaming beacon data from live players.

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

## Request body

- LiveBeaconData
  - `live_id` string, uuid, required: Live stream identifier
  - `user_id` string, required: User identifier
  - `event_type` 'join' | 'leave' | 'heartbeat', required: Type of live event
  - `timestamp` integer, required: Unix timestamp in milliseconds

## 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)