Play Links

Get a user’s play link

GET /v1/collections/{collection_id}/users/{user_id}/play-link

Response 200 OK

{
  "play_link": "https://api.nouncify.com/p/HkJ3mN8x",
  "play_url": "https://api.nouncify.com/p/HkJ3mN8x.mp3",
  "embed_html": "<iframe src=\"https://api.nouncify.com/p/HkJ3mN8x/embed\" width=\"200\" height=\"40\" frameborder=\"0\"></iframe>",
  "display_name": "Priya Patel",
  "duration_seconds": 3,
  "recorded_at": "2026-04-01T00:00:00Z",
  "status": "active"
}

Batch resolve play links

GET /v1/play-links/batch?collection_id={id}&user_ids={id1},{id2},{id3}

Resolve up to 100 play links in a single request. Ideal for rendering a list or directory.

curl "https://api.nouncify.com/v1/play-links/batch?collection_id=ABC&user_ids=id1,id2,id3" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "data": [
    {"user_id": "id1", "display_name": "Priya Patel", "has_recording": true, "play_link": "https://api.nouncify.com/p/HkJ3mN8x"},
    {"user_id": "id2", "display_name": "James Chen", "has_recording": true, "play_link": "https://api.nouncify.com/p/Xm9kL2nP"},
    {"user_id": "id3", "display_name": "Yuki Tanaka", "has_recording": false, "play_link": null}
  ]
}

Play link URL variants

Each play link supports four URL patterns:

URL	Response	Use case
/p/{token}	Mini player page	Share link, open in browser
/p/{token}.mp3	Audio redirect (302)	Direct audio playback
/p/{token}/embed	200×40px widget	Inline iframe embed
/p/{token}/meta	JSON metadata	Programmatic access