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 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
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).
A list of ISRCs that are known to be linked to the Work (example: AA6Q72000047 or AA-6Q7-20-00047).
The right holders, split into Songwriters and Publishers.
The publisher schema
The Publisher's name.
1
The Publisher's controlled status, either 'Y' or 'N'
Y
, N
, y
, n
The Publisher's unique identifier on your side
The Publisher's IPI. IPI consists of max 11 digits.
The Publisher's role (either "E", "SE" or "AM" for Original Publisher, Sub-Publisher or Administrator, respectively).
AQ
, AM
, PA
, E
, ES
, SE
, aq
, am
, pa
, e
, es
, se
The share of Mechanical rights owned by this Publisher. Shares are defined as 5 digits (i.e. 00000 no share, 10000 full share, 05000 half share).
0 <= x <= 10006
The share of Performing rights owned by this Publisher. Shares are defined as 5 digits (i.e. 00000 no share, 10000 full share, 05000 half share).
0 <= x <= 10006
The share of Synchronization rights owned by this Publisher. Shares are defined as 5 digits (i.e. 00000 no share, 10000 full share, 05000 half share).
0 <= x <= 10006
The writer schema
The Writer's name.
1
The Writer's controlled status, either 'Y' or 'N'
Y
, N
, y
, n
The Writer's unique identifier on your side.
The Writer's IPI. IPI consists of max 11 digits.
The Writer's role (e.g. 'CA' for Composer-Author, 'C' for Composer, 'A' for Author, etc.)
AD
, AR
, A
, C
, CA
, SR
, SA
, TR
, PA
, EL
, ad
, ar
, a
, c
, ca
, sr
, sa
, tr
, pa
, el
The share of Mechanical rights owned by this Writer. Shares are defined as 5 digits (i.e. 00000 no share, 10000 full share, 05000 half share).
0 <= x <= 10006
The share of Performing rights owned by this Writer. Shares are defined as 5 digits (i.e. 00000 no share, 10000 full share, 05000 half share).
0 <= x <= 10006
The share of Synchronization rights owned by this Writer. Shares are defined as 5 digits (i.e. 00000 no share, 10000 full share, 05000 half share).
0 <= x <= 10006
Details on collected royalties, on a per-territory basis
A list of territories where royalties are collected.
One of the territory codes where you collect. For Worldwide use "XW", otherwise use 2-digit ISO 3166-1 alpha-2 codes (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), a two-letter country codes standard published by the International Organization for Standardization (ISO).
The share of Mechanical royalties collected in this territory. For example, 100% becomes 10000, 50% becomes 5000, 12.50% becomes 1250, 33.3333% becomes 3333 and so on. At least one of the shares properties (sync_share or perf_share or mech_share) is required.
0 <= x <= 10006
The share of Performing royalties collected in this territory. For example, 100% becomes 10000, 50% becomes 5000, 12.50% becomes 1250, 33.3333% becomes 3333 and so on.
0 <= x <= 10006
The share of Synchronization royalties collected in this territory. For example, 100% becomes 10000, 50% becomes 5000, 12.50% becomes 1250, 33.3333% becomes 3333 and so on.
0 <= x <= 10006
Beginning of deal, in the YYYY-MM-DD format. If omitted, the date of submission will be used instead.
End of deal, in the YYYY-MM-DD format.
Provide the lyrics for this Work along with its ownership details.
The lyrics for this Work, verses separated by line feed. Remember to encode strings properly as the JSON format is used.
1
The duration in seconds of the original recording.
Lyrics in LRC format (https://en.wikipedia.org/wiki/LRC_(file_format)). Make sure the last row has the time indication and an empty lyrics line. This time will correspond to the timing of the end of the last lyrics line, example: '[04:10.010] \n'
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
}
}
}