BEbeyondwords
Ads

Get ad

Changed on

Returns a single ad by ID.

get/projects/{project_id}/ads/{id}

Request

  • Base URL
    https://api.beyondwords.io/v1
  • URL
    https://api.beyondwords.io/v1/projects/{project_id}/ads/{id}
  • Auth
    API key in header X-Api-Key

Response

OK

idinteger

Unique identifier for the object

type'custom' | 'vast'

The type of ad, either custom or vast. Ads of type custom must have title, url and media fields. Ads of type vast must have title and vast_url fields.

enabledboolean

Whether the ad will play in the BeyondWords player

placement'pre-roll' | 'mid-roll' | 'post-roll'

Whether the ad should play before/during/after the audio content. Possible values are pre-roll, mid-roll, or post-roll

vast_urlstring uri nullable

A VAST-compliant URL that contains the ads to be played

titlestring nullable

The title of the ad

click_through_urlstring uri nullable

The click-through URL of the custom ad to show in the player

image_urlstring uri nullable

The image URL to show in the player while the ad is playing

media_urlstring uri nullable

The URL of the media file of the custom ad to play in the player

audio_urlstring uri nullable

The URL of the audio file of the custom ad to play in the player

video_urlstring uri nullable

The URL of the video file of the custom ad to play in the player

theme'auto' | 'dark' | 'light' nullable

The color theme to use for the ad when it is playing. Possible values are auto, dark, light. The auto theme is based on the user's light/dark mode system preference.

createdstring

Time at which the object was created (ISO 8601)

updatedstring

Time at which the object was updated (ISO 8601)

Changes

  • 994b9853e685Revision changes
    • breaking

      the response's property type changed from object to no type for status

    • breaking

      the response's property type changed from object to no type for status

    • breaking

      the response's property type changed from object to no type for status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      added to the response property allOf list for the response status

    • info

      added to the response property allOf list for the response status

    • info

      added to the response property allOf list for the response status