List song requests

The Media Request queue: song, who asked, length and whether it was tipped.

GET https://cotlet.dev/api/v1/streamelements/song-requests

read

Returns the queue in play order, with the song, the viewer who requested it, its length and whether it was a tipped or a free request. Pass song_id to remove_song_request. Media Request needs the Loyalty System, which YouTube accounts do not have.

Parameters

No parameters.

Request

cURL
curl https://cotlet.dev/api/v1/streamelements/song-requests \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("streamelements", "list_song_requests")
Node.js
const result = await cotlet.call('streamelements', 'list_song_requests');
CLI
cotlet call streamelements list_song_requests

Example response

JSON

{
  "queue": [
    {
      "song_id": "sg_8d210e",
      "title": "Lo-fi study beats",
      "requested_by": "tess_g",
      "length_seconds": 214,
      "tipped": false
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.