Developers
Share links and embeds
Every share link has the form https://testnet.kre8.fun/s/<kind>/<id>. Paste it anywhere: link previews show a card with the
creator's avatar and name, the title, the cover art, a LIVE badge while they stream, and a QR code. If the kre8 app is
installed the link opens it; otherwise the web page opens.
#Share from the app
Press Share on a track, video, Short, live stream, profile, post, quest or coin page:
| Option | What happens |
|---|---|
| Share via… | the phone's share sheet; where files can be shared, the story image comes along |
| Copy link | your share link, with your referral code |
| WhatsApp, Telegram, X, Facebook, Messages | opens that app with the text and the link filled in |
| Share to Stories | saves the 1080x1920 story image and copies the link for a link sticker |
| Copy embed code | the <iframe> for your site |
Card images: /s/<kind>/<id>.png (1200x630) and /s/<kind>/<id>.story.png (1080x1920). Kinds: track, video,
short, live, p (profile), post, t (coin), quest. Each link carries utm_source, so you see where your
listeners come from.
#Embed on your site
Copy the code from Share → Copy embed code, or build it yourself. The player runs no trackers, loads only its own script, and any site may frame it. Free titles play right in the embed; members-only, rentals and collector titles show a button that opens kre8.
<!-- a track (100% x 152), a video (640 x 360), a Short (360 x 640) or a live stream (640 x 360) -->
<iframe src="https://testnet.kre8.fun/embed/track/TRACK_ID" width="100%" height="152"
style="border:0;border-radius:16px;max-width:100%" allow="autoplay; encrypted-media" loading="lazy"
title="My track on kre8"></iframe>
<!-- a profile card (400 x 260) or a Drop / coin card with a live price (400 x 310) -->
<iframe src="https://testnet.kre8.fun/embed/profile/alice" width="400" height="260"
style="border:0;border-radius:16px;max-width:100%" loading="lazy" title="alice on kre8"></iframe>
<iframe src="https://testnet.kre8.fun/embed/drop/0xCOIN" width="400" height="310"
style="border:0;border-radius:16px;max-width:100%" loading="lazy" title="A Drop on kre8"></iframe>| Embed | Path | Size |
|---|---|---|
| Video, Short, live | /embed/video/<id>, /embed/short/<id>, /embed/live/<id> |
640x360, 360x640, 640x360 |
| Track | /embed/track/<id> |
100% x 152 |
| Profile | /embed/profile/<name, .gully name or 0x> |
400x260 |
| Drop / coin card | /embed/drop/<0x coin> (+ .json for the numbers, CORS *) |
400x310 |
The developer dashboard builds any of these snippets from a pasted kre8 link.
#oEmbed
Link-in-bio tools, Notion, WordPress and other CMSes that support oEmbed embed kre8 links on their own:
GET https://social.kre8.fun/oembed?url=https://testnet.kre8.fun/track/TRACK_ID&format=json&maxwidth=600Tracks answer rich, videos, Shorts and live streams video, everything else link with the card as
thumbnail_url. Share pages and app pages announce the endpoint with <link rel="alternate" type="application/json+oembed">.
Only format=json is supported; a URL that is not a kre8 item answers 404.
#Share counts
GET https://social.kre8.fun/v1/share/counts?kind=track&id=TRACK_ID returns shares per network and visits per
utm_source. To count a share from your own button, POST https://social.kre8.fun/v1/share/event with
{"kind": "track", "id": "TRACK_ID", "network": "x"} (120 an hour per IP).