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>"
      ]
    }
  ]
}
'
{
  "status": "success",
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

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')