API Reference

Retrieves a VAST (Video Ad Serving Template) XML response for ad playback.

get
https://localhost:44395/api/ads/vast

Behavior: Returns a VAST XML document containing the ad creative details for playback at the specified timecode position. The response can be filtered by content categories and ad position type (pre-roll, mid-roll, post-roll).

Authorization: Public endpoint — no authentication required.

Side Effects: None.

Error Scenarios: Returns 404 if no VAST ad is available for the given parameters.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

The timecode position in the video where the ad will be inserted.

categories
array of strings

Optional content category filters for ad targeting.

categories
string

The ad position type (e.g., "preroll", "midroll", "postroll").

Responses

Updated about 21 hours ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!

Updated about 21 hours ago