GET
/share/cardGenerates 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.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| kind | string | optional | track | artist | album. Defaults to track. |
| isrc | string | optional | For kind=track: the ISRC. |
| artist | string | optional | For kind=track: artist name (use with title). |
| title | string | optional | For kind=track: track title (use with artist). |
| artist_id | integer | optional | For kind=artist: upstream artist id. |
| album_id | integer | optional | For kind=album: upstream album id. |
| theme | string | optional | dark | light. Defaults to dark. |
| format | string | optional | story (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 requesthttps://api.synkradio.co.uk/share/card?isrc=GBUM71505078&artist=Daft%20Punk&title=Around%20the%20WorldResponse
Returns binary
image/jpeg. Pipe the response body directly to a file or stream.