oEmbed & Embeds API

CLIPRAIDER links unfurl as rich cards and embeds via a standards-compliant oEmbed endpoint with auto-discovery, plus Open Graph and Twitter Card metadata on every page. This page is what embedding platforms, shell commands, and Iframely-style parsers read.

What we support

oEmbed with auto-discovery — a compliant GET /oembed?url=… endpoint (JSON or XML) advertised by <link rel="alternate" type="application/json+oembed"> tags in the <head> of pages.
Open Graph & Twitter Cards — og:*, twitter:* and JSON-LD structured data on the homepage, streamer pages and clip pages, present in the raw HTML (no JavaScript required).

oEmbed endpoint

Item	Value
Endpoint	`https://clipraider.com/oembed?url=<url>`
Method	`GET`
url (required)	A clipraider.com (or www.clipraider.com) page URL, URL-encoded.
format (optional)	`json` (default) or `xml`.
Success	`200` `application/json` or `application/xml`.
Errors	`400` missing/invalid params · `404` unsupported host.
Caching	Edge-cached (`s-maxage=600`); CORS open (`Access-Control-Allow-Origin: *`).

Discovery

Pages that can be embedded advertise the endpoint in their <head>:

<link rel="alternate" type="application/json+oembed"
      title="CLIPRAIDER oEmbed"
      href="https://clipraider.com/oembed?url=https%3A%2F%2Fclipraider.com%2Fstreamer%2Ftwitch%2Fjynxzi">

What each URL resolves to

URL pattern	oEmbed type	What you get
`/streamer/twitch/{key}` · `/streamer/youtube/{key}`	`video`	Twitch/YouTube player `html` embed + thumbnail + author.
`/streamer/kick/{key}`	`link`	Link card (title + thumbnail + author); Kick has no reliable frameable player.
`/clips/{id}` (Twitch/YouTube clips)	`video`	Twitch/YouTube clip player `html` embed.
`/clips/{id}` (Kick / X / Reddit clips)	`link`	Link card (these play as native video, not iframe-embeddable).
Homepage / any other page	`link`	Generic link card with the CLIPRAIDER og:image.

Example — link card (homepage)

curl "https://clipraider.com/oembed?url=https%3A%2F%2Fclipraider.com%2F"
{
  "version": "1.0",
  "provider_name": "CLIPRAIDER",
  "provider_url": "https://clipraider.com",
  "type": "link",
  "title": "CLIPRAIDER - Live Streams & Clips: Twitch, Kick, YouTube",
  "url": "https://clipraider.com/",
  "thumbnail_url": "https://clipraider.com/og-image.png"
}

Example — video embed (live streamer)

curl "https://clipraider.com/oembed?url=https%3A%2F%2Fclipraider.com%2Fstreamer%2Ftwitch%2Fjynxzi"
{
  "version": "1.0",
  "provider_name": "CLIPRAIDER",
  "provider_url": "https://clipraider.com",
  "type": "video",
  "title": "Jynxzi live on twitch",
  "author_name": "Jynxzi",
  "author_url": "https://twitch.tv/jynxzi",
  "thumbnail_url": "https://static-cdn.jtvnw.net/previews-ttv/live_user_jynxzi-440x248.jpg",
  "thumbnail_width": 440,
  "thumbnail_height": 248,
  "url": "https://clipraider.com/streamer/twitch/jynxzi",
  "html": "<iframe src=\"https://player.twitch.tv/?channel=jynxzi&parent=clipraider.com&autoplay=false\" ...></iframe>",
  "width": 1280,
  "height": 720
}

Example embed code

The html field is a responsive, 16:9, frameborder-0 iframe ready to drop into any consumer:

<iframe src="https://player.twitch.tv/?channel=jynxzi&parent=clipraider.com&autoplay=false"
        title="Jynxzi live on twitch" frameborder="0"
        allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
        allowfullscreen
        style="width:100%;aspect-ratio:16/9;border:0;border-radius:12px"></iframe>

XML output is available with &format=xml. Live streamer and clip pages rotate with the live feed, so a URL that has gone offline falls back to a link card rather than erroring.