oEmbed Server
Making it easier to embed your Knight Lab stories.
There's really no reason to visit this page, but in case you ended up here, this is what's going on.
oEmbed is a system to help third party sites embed content. It's the protocol that supports, for some CMSes, the ability to just put a URL to a Knight Lab Timeline (or other embeddable content) on a single line, and have the full story pulled in.
Each CMS is different; typically the adminstrator needs to do some configuration. Some people pay for service from Embedly to simplify the configuration. Embedly supports several Knight Lab story types, and we will try to keep them up to date as we add new services. It's because of Embedly that you can embed our stories on Medium.com. (See our blog post announcing that.)
Using this server directly
This server handles a number of oEmbed URL schemes. For all of them, use the same endpoint: https://oembed.knightlab.com
. If no url
parameter is provided, this instructional page appears.
If the url
parameter value matches one of the following patterns, a JSON response will be returned. Otherwise, the server will return a 404 Not Found
error.
This endpoint also supports the format
, maxwidth
, and maxheight
request parameters. Valid values for format
are json
and xml
. If no format is specified, JSON is the default response type.
Service | Pattern |
---|---|
TimelineJS | ^https?://cdn.knightlab.com/libs/timeline3/.+$ |
StoryMapJS | ^https?://uploads.knightlab.com/storymapjs/.+$ |
JuxtaposeJS | ^https?://cdn.knightlab.com/libs/juxtapose/.+$ |
SceneVR | ^https?://uploads.knightlab.com/scenevr/.+$ |
StoryLineJS | ^https?://cdn.knightlab.com/libs/storyline/.+$ |
They Draw It | ^https?://theydrawit.mucollective.co/vis/.+$ |