POST
/
ws
/
1.1
/
work.post
curl --request POST \
  --url https://api.musixmatch.com/ws/1.1/work.post \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "collection": {
      "territories": [
        {
          "code": "IT",
          "mech_share": 10000,
          "sync_share": 10000
        }
      ],
      "validity_begin": "2023-07-17"
    },
    "identifier": "00001100196005",
    "owners": {
      "publisher": [
        {
          "controlled": "Y",
          "name": "Sony/Atv Tunes Llc"
        }
      ],
      "writer": [
        {
          "controlled": "Y",
          "mech_ownership_share": 5000,
          "name": "John Lennon",
          "role": "CA",
          "sync_ownership_share": 5000
        },
        {
          "controlled": "Y",
          "mech_ownership_share": 5000,
          "name": "Paul McCartney",
          "role": "CA",
          "sync_ownership_share": 5000
        }
      ]
    }
  }
}'
{
  "message": {
    "body": {
      "alternate_titles": [
        {
          "title": "Yellow Submarine"
        }
      ],
      "collections": {
        "2023-07-17": {
          "territories": [
            {
              "code": "IT",
              "countries": [
                "IT"
              ],
              "mech_share": 10000,
              "perf_share": 0,
              "publisher": null,
              "sync_share": 10000
            }
          ],
          "validity_begin": "2023-07-17",
          "validity_end": null
        }
      },
      "identifier": "00001100196005",
      "is_disabled": 0,
      "isrc": [],
      "iswc": "",
      "last_trasmission": "2023-07-17",
      "owners": {
        "publisher": [
          {
            "controlled": "Y",
            "id": 211,
            "identifier": "",
            "ipi": "00000000000",
            "mech_ownership_share": 0,
            "mech_society": null,
            "name": "Sony/Atv Tunes Llc",
            "perf_ownership_share": 0,
            "perf_society": null,
            "role": null,
            "sync_ownership_share": 0,
            "sync_society": null,
            "type": "publisher",
            "validity_begin": "2023-07-17"
          }
        ],
        "writer": [
          {
            "controlled": "Y",
            "id": 11353,
            "identifier": "",
            "ipi": "00000000000",
            "mech_ownership_share": 5000,
            "mech_society": null,
            "name": "John Lennon",
            "perf_ownership_share": 0,
            "perf_society": null,
            "role": "CA",
            "sync_ownership_share": 5000,
            "sync_society": null,
            "type": "writer",
            "validity_begin": null
          },
          {
            "controlled": "Y",
            "id": 11354,
            "identifier": "",
            "ipi": "00000000000",
            "mech_ownership_share": 5000,
            "mech_society": null,
            "name": "Paul McCartney",
            "perf_ownership_share": 0,
            "perf_society": null,
            "role": "CA",
            "sync_ownership_share": 5000,
            "sync_society": null,
            "type": "writer",
            "validity_begin": null
          }
        ]
      },
      "ownership": [],
      "performers": [],
      "publisher_short_name": "Sony",
      "source": {
        "affiliation": null,
        "control": false,
        "created": "2011-12-09",
        "credits_priority": "15",
        "description": "SonyATV / EMI",
        "id": 1,
        "last_updated": "2024-10-22 16:47:38",
        "report": "create",
        "sender_id": "00269021863",
        "sender_name": "SONY/ATV MUSIC PUBLISHING LLC",
        "short_name": "Sony",
        "type_of_right": "SYN",
        "validity_begin": "2010-11-04",
        "validity_end": null
      },
      "submissions": [
        {
          "creation_date": "2023-07-17",
          "disabled": "N",
          "filename": "api-works-2023-07-17.json",
          "id": 3401968,
          "source": 1,
          "transmission_date": "2023-07-17"
        }
      ],
      "tablespace": "works",
      "title": "Yellow Submarine",
      "type_of_right": "SYN",
      "validity_begin": null,
      "validity_end": "2024-10-20",
      "wgid": "works:191813604",
      "work_id": 191813604
    },
    "header": {
      "execute_time": 0.63219499588013,
      "status_code": 200
    }
  }
}

Use this API to submit new or updated publishing data.

This API is designed for publishers to post royalty information associated to a musical production (that is, a track). The API supports the transmission of detailed information, including licenses and their ownership quota allocations, royalties collection on a per-territory basis, and other essential metadata such as ISRC codes, performer names, and alternate titles, which are crucial for accurate work matching across various sources that partecipate in the royalties collection and our catalog. If you are a label and you’d like to send us lyrics in bulk, please refer to our commercial department.

Please note that you are responsible for transmitting only trustworthy and verified data.

Authorizations

apikey
string
query
required

Body

application/json

The data schema for submitting data of a musical work.

value
object

Response

200 - application/json
200 OK / 401 Unauthorized / 400 Bad Request
message
object