Skip to main content
POST
/
api
/
songs
cURL
curl --request POST \
  --url https://api.recoupable.com/api/songs \
  --header 'Content-Type: application/json' \
  --data '
{
  "songs": [
    {
      "isrc": "<string>",
      "name": "<string>",
      "album": "<string>",
      "notes": "<string>",
      "artists": [
        "<string>"
      ]
    }
  ]
}
'
{
  "songs": [
    {
      "isrc": "<string>",
      "name": "<string>",
      "album": "<string>",
      "notes": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "artists": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "timestamp": 123
        }
      ]
    }
  ],
  "error": "<string>"
}
This endpoint performs bulk create/fetch operations. For each song, the API attempts to look up metadata via internal search. If no data is found, optional fallback fields (name, album, notes, artists) are used.

Body

application/json

Array of songs to create or fetch

​
songs
object[]
required

Array of song inputs for bulk create/fetch

Response

Songs created or fetched successfully

Response containing songs data

​
status
enum<string>

Status of the request

Available options:
success,
error
​
songs
object[]

Array of song objects with artist information

​
error
string

Error message (only present if status is 'error')