Adventr provides an oEmbed API so that developers and website CMSes can easily extract Adventr embed codes from published Adventr projects.

API Endpoint:

  • https://adventr.io/oembed

Parameters:

url (required) - accepted formats:

  • https://adventr.io/campaigns/published/*

format (optional)

  • Currently only json is supported

maxwidth (optional)

  • Specify the maximum width for the embed in pixels (so that the embed size respects the original aspect ratio)

maxheight (optional)

  • Specify the maximum height for the embed in pixels (so that the embed size respects the original aspect ratio)

width (optional)

  • Specify the specific width for the embed in pixels

height (optional)

  • Specify the specific height for the embed in pixels

callback (optional)

  • Returns jsonp response format. callback is the name of the JavaScript function to execute.

Example:

Request: 

GET https://adventr.io/oembed?url=https://adventr.io/campaigns/published/marc-jacobs-v3-27475913

Response: 

{
    "type": "video",
    "version": "1.0",
    "provider_name": "Adventr",
    "provider_url": "https://adventr.io/",
    "title": "THE DOG'S ADVENTURE",
    "html": "<iframe src=\"https://player.adventr.io/video?link=https%3A%2F%2Fd252srr1zuysk4.cloudfront.net%2Fclients%2F7%2F186%2Fpublished%2F7-marc-jacobs-v3-27475913.data\" width=\"960px\" height=\"540px\" frameborder=\"0\" scrolling=\"no\" allowfullscreen allow=\"autoplay; fullscreen\"></iframe>",
    "width": 960,
    "height": 540,
    "description": "THE DOG'S ADVENTURE BY MARC JACOBS",
    "thumbnail_url": "https://d252srr1zuysk4.cloudfront.net/clients/7/186/thumbnails/intro-spottyorshaggy-arrow2reupload-tfpm.0000000.jpg",
    "thumbnail_width": 640,
    "thumbnail_height": 360
}