Fetch all leads captured through the CTA form on a specific video. Leads are returned in reverse chronological order (most recent first).
Endpoint
Authentication
Pass your API key as a Bearer token in the Authorization header.
Your API key. Format: Bearer <api_key>.
Path parameters
The ID of the video to retrieve leads for.
Response
Array of lead objects ordered by most recent submission first. Empty array when no leads exist. ID of the video this lead was captured from.
Key-value map of the form fields submitted by the viewer. Field keys match the CTA form configuration on the domain.
ISO 8601 timestamp when the form was submitted.
Name of the video at the time of submission.
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
Status Description 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
{
"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"
}
]
}
}