SYNK
GET/share/card

Generates an Instagram-ready PNG share card (1080x1920 story, or 1080x1080 square) for a track, artist or album. Dark or light theme. Great for "now playing" embeds, marketing previews, or social bots.

Rate limit
30 req/min
Caching
Cached 24h on the Cloudflare edge, keyed on all params.

Notes

  • Layout is a giant circular cover clipped by the top and sides of the canvas, with title, subtitle and a "Listen now on SYNK Music" footer linking to synkmusic.com.
  • Writers, producers and the record label are shown as a small muted credits block underneath the footer (tracks and albums only).
  • Rendered by a dedicated Node + Satori service fronted by nginx, then proxied and cached at the edge.
  • Cached for 24 hours on the Cloudflare edge, keyed on all params.
  • Designed to look good in Instagram Stories, Twitter previews, TikTok uploads or as a standalone share asset.
  • Also reachable at the legacy path /share-card, which is kept as an alias. New integrations should use /share/card.
Authentication
Send a User-Agent header containing a contact email. See authentication.

Parameters

NameTypeRequiredDescription
kindstringoptionaltrack | artist | album. Defaults to track.
isrcstringoptionalFor kind=track: the ISRC.
artiststringoptionalFor kind=track: artist name (use with title).
titlestringoptionalFor kind=track: track title (use with artist).
artist_idintegeroptionalFor kind=artist: upstream artist id.
album_idintegeroptionalFor kind=album: upstream album id.
themestringoptionaldark | light. Defaults to dark.
formatstringoptionalstory (1080x1920) | square (1080x1080). Defaults to story.

Request

curl 'https://api.synkradio.co.uk/share/card' \
  -H 'User-Agent: [email protected]'

Try it

GETTry it
Sends a real request
https://api.synkradio.co.uk/share/card?kind=track&isrc=USIR20400274&artist=Daft%20Punk&title=Around%20the%20World&album_id=302127&theme=light&format=square

Response

Returns binary image/png. Pipe the response body directly to a file or stream.
Previous/resolve