POST
/
ws
/
1.1
/
work.post
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
        }
      ]
    },
    "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
    }
  }
}
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

Response

200 - application/json

200 OK / 400 Bad Request / 401 Unauthorized

The response is of type object.