Skip to content
Back to Nouncify

Play Links Guide

Play links provide stable, shareable URLs for audio playback. Each recorded name gets a unique 8-character token.

URLContent-TypeUse case
https://api.nouncify.com/p/{token}HTMLShareable mini player page
https://api.nouncify.com/p/{token}.mp3Audio redirectDirect playback or <audio> tag
https://api.nouncify.com/p/{token}/embedHTML widgetInline iframe (200×40px)
https://api.nouncify.com/p/{token}/metaJSONProgrammatic access
<iframe
src="https://api.nouncify.com/p/HkJ3mN8x/embed"
width="200"
height="40"
frameborder="0"
title="Listen to Priya's name"
></iframe>
<audio controls preload="none">
<source src="https://api.nouncify.com/p/HkJ3mN8x.mp3" type="audio/mpeg">
</audio>
const playName = (token) => {
const audio = new Audio(`https://api.nouncify.com/p/${token}.mp3`);
audio.play();
};

For directories or lists with many names, use the batch endpoint:

Terminal window
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.

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.