Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.demomatic.tech/llms.txt

Use this file to discover all available pages before exploring further.

Fetch all leads captured through the CTA form on a specific video. Leads are returned in reverse chronological order (most recent first).

​
Endpoint

GET /v1/videos/:id/leads

​
Authentication

Pass your API key as a Bearer token in the Authorization header.
​
Authorization
string
required
Your API key. Format: Bearer <api_key>.

​
Path parameters

​
id
number
required
The ID of the video to retrieve leads for.

​
Response

​
data
object
required
This endpoint only returns leads from CTA form submissions. Clicks on external link CTAs are tracked separately in the link_clicks field returned by Video Stats.

​
Error responses

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

​
Examples

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

​
Response

200
{
  "data": {
    "leads": [
      {
        "id": 42,
        "video_id": 7,
        "response_data": {
          "name": "Alice Smith",
          "email": "alice@example.com"
        },
        "submitted_at": "2024-01-15T10:30:00.000Z",
        "internal_name": "Product Tour Q1 2024"
      }
    ]
  }
}