searchferret.

Link previews

Paste a link.
It plays.

Every published searchferret video has a share link, and that link unfurls into an inline player wherever your team pastes it. Notion, Slack, Discord, Teams, Confluence, Coda... anywhere that reads Open Graph or oEmbed. There's nothing to install and no key to create.

Start your 14-day trialTry the live demo

14 days free. No card required. Unlimited teammates on every team plan.

Try it

See it in action.

Paste the link of any published searchferret video. This calls the same endpoint Notion and friends call, and renders exactly what they render.

How it works

Two standards, one embed page.

Open Graph tags
Every published watch page carries og:video and twitter:player tags with the real thumbnail. Slack, Discord, Teams and iMessage read these to show the card and the inline player.
oEmbed discovery
The watch page also links to our oEmbed endpoint. Notion, Confluence, Coda and friends follow that link, ask the endpoint how to embed the video, and get an iframe back.
A stable embed page
Both roads lead to the same place: a dedicated embed page per video that any site may put in an iframe. You can use it directly too, in your wiki, help centre, or LMS.

Reference

The oEmbed endpoint.

Most tools find this on their own through the discovery tag on watch pages. It's here for the ones that ask you to paste an endpoint by hand, and for anyone building their own integration.

Request:

GET https://searchferret.com/api/oembed?url=https://searchferret.com/videos/VIDEO_ID

Parameters

urlrequiredThe watch link to embed, like https://searchferret.com/videos/VIDEO_ID. Published videos only.
formatoptionalOnly json is supported. Anything else returns 501, per the oEmbed spec.
maxwidthoptionalLargest width you can display, in pixels. The response is scaled down to fit, keeping the video's aspect ratio.
maxheightoptionalLargest height you can display. Combines with maxwidth; the tighter of the two wins.

Response (type "video", per the oEmbed spec):

{
  "type": "video",
  "version": "1.0",
  "title": "Sprint 12 standup",
  "provider_name": "searchferret",
  "provider_url": "https://searchferret.com",
  "html": "<iframe src=\"https://searchferret.com/embed/videos/VIDEO_ID\" width=\"960\" height=\"540\" ...></iframe>",
  "width": 960,
  "height": 540,
  "thumbnail_url": "https://.../thumbnail.jpg",
  "thumbnail_width": 1280,
  "thumbnail_height": 720,
  "duration": 93
}

Errors

400No url parameter was given.
401The video is password protected. Gated videos deliberately have no previews.
404The url isn't a watch link, the video doesn't exist, or it isn't published and ready yet.
501A format other than json was requested.

Direct embeds

Skip the unfurl, use the iframe.

Every published video also has its own embed page. If your wiki, help centre, or LMS takes raw HTML, this is all it needs. No player code to host, nothing to keep up to date. 

<iframe
  src="https://searchferret.com/embed/videos/VIDEO_ID"
  width="960" height="540" frameborder="0"
  allow="autoplay; fullscreen; picture-in-picture"
  allowfullscreen></iframe>

Frequently asked questions.

Record it once.
Paste it everywhere.

Publish a recording, copy the link, and it plays wherever your team already works.

Start your 14-day trialAll integrations