Skip to main content
POST
/
ws
/
1.1
/
work.post
work.post
curl --request POST \
  --url 'https://api.musixmatch.com/ws/1.1/work.post?apikey=' \
  --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
        }
      ]
    },
    "title": "Yellow Submarine"
  }
}
'
{
  "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
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.musixmatch.com/llms.txt

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

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 / 400 Bad Request / 401 Unauthorized

​
message
object