Skip to main content
POST
/
api
/
catalogs
/
songs
cURL
curl --request POST \
  --url https://api.recoupable.com/api/catalogs/songs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "songs": [
    {
      "catalog_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "isrc": "<string>",
      "name": "<string>",
      "album": "<string>",
      "notes": "<string>",
      "artists": [
        "<string>"
      ]
    }
  ]
}
'
{
  "status": "success",
  "songs": [
    {
      "catalog_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "isrc": "<string>",
      "name": "<string>",
      "album": "<string>",
      "lyrics": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "artists": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "timestamp": 123
        }
      ]
    }
  ],
  "pagination": {
    "total_count": 123,
    "page": 123,
    "limit": 123,
    "total_pages": 123
  },
  "error": "<string>"
}
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.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Array of songs to add to catalog

songs
object[]
required

Array of songs for batch updates

Response

Songs added to catalog successfully

Response containing catalog songs data with pagination

status
enum<string>

Status of the request

Available options:
success,
error
songs
object[]

Array of song objects with artist information

pagination
object

Pagination metadata for the response

error
string

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