Create Songs

Bulk create or fetch songs by ISRC. 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.

POST /api/songs

cURL

cURL

curl --request POST \
  --url https://api.recoupable.com/api/songs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "songs": [
    {
      "isrc": "<string>",
      "name": "<string>",
      "album": "<string>",
      "notes": "<string>",
      "artists": [
        "<string>"
      ]
    }
  ]
}
'

200

{
  "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.

Authorizations

x-api-key · string · header · required

Your Recoup API key. Learn more.

Body

application/json

Array of songs to create or fetch

songs · object[] · required

Array of song inputs for bulk create/fetch

Show child attributes

Response

200

application/json

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

Show child attributes

error · string

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