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 copyright information associated to a musical work (intellectual property). The API supports the transmission of detailed information, including their ownership shares along with collection shares 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 music 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.

data
object

Response

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