Skip to main content
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 response data 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

  1. Player sends ad-request -> receives ad-response (containing news + ad + pop URLs).
  2. Player pre-caches content.
  3. Player plays the content.
  4. Player fires the proof-of-play GET request. Must happen within 1 hour of the original request.
  5. Repeat for next spot.

Example Request

Last modified on April 22, 2026