Sign in

v1

latestOpenAPI 3.1.02026-07-1750229379.2 KB
oEmbed

Get oEmbed data

Returns oEmbed data for a Figma file or published Make site URL, following the oEmbed specification.

get/v1/oembed

Query parameters

urlstring required

The URL of the Figma file or published Make site to retrieve oEmbed data for.

maxwidthinteger

Maximum width of the embed in pixels. Defaults to 800. The response width will be adjusted to maintain a 16:9 aspect ratio with maxheight.

maxheightinteger

Maximum height of the embed in pixels. Defaults to 450. The response height will be adjusted to maintain a 16:9 aspect ratio with maxwidth.

Response

Response from the GET /v1/oembed endpoint.

versionstring required

The oEmbed specification version. Always "1.0".

typestring required

The oEmbed response type. Always "rich".

titlestring required

The title of the Figma file or published Make site.

keystring

The key of the Figma file. Not present for published Makes

urlstring required

The canonical URL of the resource.

provider_namestring required

The name of the content provider. Always "Figma" or "Make".

provider_urlstring required

The URL of the content provider's website. Always "https://www.figma.com".

cache_ageinteger required

Suggested cache lifetime for this response in seconds. Always 3600.

widthinteger required

Width of the embed in pixels.

heightinteger required

Height of the embed in pixels.

htmlstring required

The HTML for embedding the file. Contains an iframe pointing to the Figma embed URL.

is_published_siteboolean

Only present and "true" when the resource is a published Make.

folder_namestring

The name of the folder containing the file, if the file resides in a folder.

thumbnail_urlstring

URL of a thumbnail image for the file.

thumbnail_widthinteger

Width of the thumbnail image in pixels.

thumbnail_heightinteger

Height of the thumbnail image in pixels.