Get Spot
Get Spot
Request a single creative for a single playout on a specific screen.
GET
Get Spot
Get Spot
Request a single creative for a single playout on a specific screen. Returns content (news or ad) along with a proof-of-play URL. This is part of the Vendor Default API for real-time ad serving, separate from the SMAPI CRUD endpoints.Need a test campaign?
To set up a test campaign for your screens, contact support@framen.com with one or multiple
screen_id you want to test with.string
required
Your organization token (e.g.,
Org_4KmTqZnWpLx).string
required
The unique identifier of the screen requesting content.
Response
The responsedata object contains:
The
data object also contains two nested content objects: news and ad. Both share the same schema:
The
news object additionally contains:
Request Cycle Flow
- Player sends ad-request -> receives ad-response (containing news + ad + pop URLs).
- Player pre-caches content.
- Player plays the content.
- Player fires the proof-of-play GET request. Must happen within 1 hour of the original request.
- Repeat for next spot.
Example Request
Last modified on April 22, 2026