integrate a digital signage player/cms with vistar media's ad serving api to request and play programmatic dooh ads
domain: developers.vistarmedia.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Obtain a network_id and api_key credential pair via the Vistar ad platform (Admin > API Access)
POST an ad request to /api/v1/get_ad/json (sandbox: sandbox-api.vistarmedia.com, production: api.vistarmedia.com) including venue_id, display_time, and one or more display_area objects (dimensions, supported mime types, durations)
Parse the response for one or more advertisement objects (asset_url, creative_id, lease_expiry, proof_of_play_url) keyed to display_area_id
Optionally pre-fetch and cache creatives via the Creative Caching endpoint to handle poor connectivity
After playback, fetch proof_of_play_url to report the play (expect HTTP 204); fetch expiration_url instead if the ad will not be shown
For campaign/venue/creative management (not ad serving) use the separate Marketplace SSP API at platform-api.vistarmedia.com with session-cookie auth
Known gotchas
Ad Serving auth (network_id/api_key) is entirely separate from the Marketplace SSP API auth (session cookie via POST /api/session, valid 8 hours) — don't conflate the two
proof_of_play_url can be fetched only once and has a limited lease (24h for flexible campaigns, 15 min for exchange campaigns) — late reporting loses the impression
image/jpg is explicitly rejected as a mime type (must use image/jpeg); ad requests without venue_id have been invalid since May 2023
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?