work.post
Submit a musical work’s details.
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 updates of your publishing data.
This API is designed for and dedicated to publishers for posting royalties associated to a musical production (track). If you are a label and you’d like to send us lyrics in bulk, please refer to our commercial department.
Such details include licenses and their respective ownership quotas, collected royalties on a per-territory basis, plus some additional metadata that helps us match your Work with other Works submitted by other sources that partecipate in the royalties collection, and with the songs in our catalog — e.g. ISRCs, Performers, alternate titles.
Please note that you are responsible for transmitting only trustworthy and verified data.
Authorizations
Body
The data schema for submitting data of a musical work.
Your Musical Work’s unique identifier. Submitting updated data with the same 'identifier' creates a new version of the same Work.
1 - 40
The Work's title.
1
A list of known alternate titles
The ISWC of the Work being submitted (example: T3452468001 or T-123456789-1).
1
A list of ISRCs that are known to be linked to the Work (example: AA6Q72000047 or AA-6Q7-20-00047).
Response
"Yellow Submarine"
[{ "title": "Yellow Submarine" }]
[
{
"code": "IT",
"countries": ["IT"],
"mech_share": 10000,
"perf_share": 0,
"publisher": null,
"sync_share": 10000
}
]
"2023-07-17"
"00001100196005"
0
[]
""
"2023-07-17"
"Y"
211
""
"00000000000"
0
"Sony/Atv Tunes Llc"
0
0
"publisher"
"2023-07-17"
[
{
"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"
}
]
"Y"
11353
""
"00000000000"
5000
"John Lennon"
0
"CA"
5000
"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
}
]
[]
[]
"Sony"
false
"2011-12-09"
"15"
"SonyATV / EMI"
1
"2024-10-22 16:47:38"
"create"
"00269021863"
"SONY/ATV MUSIC PUBLISHING LLC"
"Sony"
"SYN"
"2010-11-04"
"2023-07-17"
"N"
"api-works-2023-07-17.json"
3401968
1
"2023-07-17"
[
{
"creation_date": "2023-07-17",
"disabled": "N",
"filename": "api-works-2023-07-17.json",
"id": 3401968,
"source": 1,
"transmission_date": "2023-07-17"
}
]
"works"
"Yellow Submarine"
"SYN"
"2024-10-20"
"works:191813604"
191813604
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
}
}
}