Play Links Guide
Play links provide stable, shareable URLs for audio playback. Each recorded name gets a unique 8-character token.
URL formats
Section titled “URL formats”| URL | Content-Type | Use case |
|---|---|---|
https://api.nouncify.com/p/{token} | HTML | Shareable mini player page |
https://api.nouncify.com/p/{token}.mp3 | Audio redirect | Direct playback or <audio> tag |
https://api.nouncify.com/p/{token}/embed | HTML widget | Inline iframe (200×40px) |
https://api.nouncify.com/p/{token}/meta | JSON | Programmatic access |
Embed in your app
Section titled “Embed in your app”Inline player widget
Section titled “Inline player widget”<iframe src="https://api.nouncify.com/p/HkJ3mN8x/embed" width="200" height="40" frameborder="0" title="Listen to Priya's name"></iframe>HTML5 audio element
Section titled “HTML5 audio element”<audio controls preload="none"> <source src="https://api.nouncify.com/p/HkJ3mN8x.mp3" type="audio/mpeg"></audio>Custom play button
Section titled “Custom play button”const playName = (token) => { const audio = new Audio(`https://api.nouncify.com/p/${token}.mp3`); audio.play();};Batch resolution
Section titled “Batch resolution”For directories or lists with many names, use the batch endpoint:
curl "https://api.nouncify.com/v1/play-links/batch?collection_id=ABC&user_ids=id1,id2,id3" \ -H "Authorization: Bearer YOUR_API_KEY"This returns up to 100 play links in a single request, ideal for rendering team directories or event attendee lists.
Rate limits
Section titled “Rate limits”Play link endpoints have a generous rate limit of 1,000 requests per minute per IP to support directory-style pages with many audio players.