Video Stats

Fetch view, lead, and link click counts for a specific video.

Endpoint

GET /v1/videos/:id/stats

Authentication

Pass your API key as a Bearer token in the Authorization header.

string

required

Your API key. Format: Bearer <api_key>.

Path parameters

number

required

The ID of the video to retrieve stats for.

Response

object

required

Hide properties

number

required

Total number of unique viewers.

number

required

Number of CTA form submissions. This is 0 for videos with an external link CTA.

number

required

Number of CTA external link clicks. This is 0 for videos with a form CTA.

leads and link_clicks are mutually exclusive based on your CTA type. A video with a form CTA will always have link_clicks: 0, and a video with an external link CTA will always have leads: 0.

Error responses

Status	Description
`400`	The provided `id` is not a valid number.
`404`	No video found with the given ID in your account.

Examples

curl --request GET \
  --url https://api.demomatic.tech/v1/videos/123/stats \
  --header 'Authorization: Bearer YOUR_API_KEY'

const videoId = 123;

const response = await fetch(`https://api.demomatic.tech/v1/videos/${videoId}/stats`, {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  },
});

const { data } = await response.json();
console.log(data.views, data.leads, data.link_clicks);

Response

200

{
  "data": {
    "views": 142,
    "leads": 17,
    "link_clicks": 0
  }
}

Overview

Videos

Domains

Endpoint

Authentication

Path parameters

Response

Error responses

Examples

Response

​Endpoint

​Authentication

​Path parameters

​Response

​Error responses

​Examples

​Response

Endpoint

Authentication

Path parameters

Response

Error responses

Examples

Response