Dieser Abschnitt enthält Beispiele für Anfragen und Antworten für gängige Avails-API-Operationen. Jedes Beispiel zeigt die richtige JSON-Struktur und die erforderlichen Felder, sodass Sie Ihre Integration mit Prime Video erstellen und testen können. Verwenden Sie diese Beispiele als Vorlagen, wenn Sie Ihre Verfügbarkeiten einreichen und aktualisieren. Sie können sie direkt in Ihre Konsole kopieren, um Ihre Implementierung zu überprüfen, bevor Sie Inhalte an Prime Video bereitstellen.
Avails-API-Nutzdatenbeispiele erstellen/aktualisieren
Mit der Avails-API können Sie Verfügbarkeitsfenster für Ihre Inhalte im Prime Video-System erstellen und aktualisieren. Dieser Abschnitt enthält Beispiele für Anfragen und Antworten und zeigt, wie Sie Ihre API-Aufrufe für verschiedene Szenarien strukturieren können.
Beispiel 1: Kanalfolge mit mehreren Avails
Anfrage 1: Verfügbarkeit auf Episodenebene mit 2 Fenstern - Mit dieser Anfrage wird die Verfügbarkeit einer Episode auf einem Abonnementkanal mit den beiden Videoformaten UHD und HD hergestellt:
{
"avail": {
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "DemoDMA_Title_ID"
}
],
"ALID": "demoALID",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Episode",
"EpisodeMetadata": {
"TitleInternalAlias": [
"Avail Strikes Back: Season 1, Episode 2"
],
"EpisodeNumber": {
"Number": 2
},
"SeasonMetadata": {
"SeasonContentID": "demoALID_For_Season_01",
"SeasonTitleInternalAlias": [
"Avail Strikes Back: Season 1"
],
"SeasonNumber": {
"Number": 1
},
"NumberOfEpisodes": 77
},
"SeriesMetadata": {
"SeriesContentID": "demoALID_For_Series",
"SeriesTitleInternalAlias": [
"Avail Strikes Back"
],
"NumberOfSeasons": 4
}
}
}
],
"Transaction": [
{
"_TransactionID": "availId123",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"ContractID": "CPH",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "mgm_plus_subscription"
},
{
"_termName": "adKey",
"Text": "Break776353"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "RentalDuration",
"Duration": "PT720H"
},
{
"_termName": "WatchDuration",
"Duration": "PT48H"
},
{
"_termName": "Exclusive",
"Boolean": true
},
{
"_termName": "ExclusiveAttributes",
"Text": "SECOND_RUN_EXCLUSIVE"
}
]
},
{
"_TransactionID": "availId456",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"ContractID": "CPH",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "mgm_plus_subscription"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "RentalDuration",
"Duration": "PT720H"
},
{
"_termName": "WatchDuration",
"Duration": "PT48H"
},
{
"_termName": "Exclusive",
"Boolean": false
}
]
}
]
}
}
Anfrage 2: Verfügbarkeit auf Saisonebene für ein einzelnes Videofenster - Mit dieser Anfrage wird die Verfügbarkeit für die gesamte Staffel 1 auf einem anderen Abonnementkanal im SD-Format gewährleistet:
{
"avail": {
"ALID": "demoALID_For_Season_01",
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "DemoDMA_Title_ID"
}
],
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID_For_Season_01",
"WorkType": "Season",
"SeasonMetadata": {
"SeasonContentID": "demoALID_For_Season_01",
"SeasonTitleInternalAlias": [
"Avail Strikes Back: Season 1"
],
"SeasonNumber": {
"Number": 1
},
"NumberOfEpisodes": 77,
"SeriesMetadata": {
"SeriesContentID": "demoALID_For_Series",
"SeriesTitleInternalAlias": [
"Avail Strikes Back"
],
"NumberOfSeasons": 4
}
}
}
],
"Transaction": [
{
"_TransactionID": "availId789season",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"ContractID": "CPH",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "A4K"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "RentalDuration",
"Duration": "PT720H"
},
{
"_termName": "WatchDuration",
"Duration": "PT48H"
},
{
"_termName": "Exclusive",
"Boolean": false
}
]
}
]
}
}
Beispiel 2: FVOD-Film mit mehreren Locales
{
"avail": {
"ALID": "demoALID",
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "DemoDMA_Title_ID"
}
],
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Movie",
"Metadata": {
"TitleInternalAlias": [
"Harry Potter and Marge Simpson"
]
}
}
],
"Transaction": [
{
"_TransactionID": "availId123movie",
"LicenseType": "FVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "No"
},
{
"_termName": "Exclusive",
"Boolean": true
},
{
"_termName": "ExclusiveAttributes",
"Text": "SECOND_RUN_EXCLUSIVE"
}
]
},
{
"_TransactionID": "availId456movie",
"LicenseType": "FVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "No"
},
{
"_termName": "Exclusive",
"Boolean": false
}
]
}
]
}
}
Beispiel 3: TVOD-Film
{
"avail": {
"ALID": "demoALID",
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "DemoDMA_Title_ID"
}
],
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Movie",
"Metadata": {
"TitleInternalAlias": [
"Harry Potter and Marge Simpson"
]
}
}
],
"Transaction": [
{
"_TransactionID": "availId123movie",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "SRP",
"Money": {
"value": 8.99,
"_currency": "USD"
}
},
{
"_termName": "WSP",
"Money": {
"value": 7.99,
"_currency": "USD"
}
},
{
"_termName": "RentalDuration",
"Duration": "PT720H"
},
{
"_termName": "WatchDuration",
"Duration": "PT48H"
},
{
"_termName": "Download",
"Text": "No"
},
{
"_termName": "Exclusive",
"Boolean": true
},
{
"_termName": "ExclusiveAttributes",
"Text": "SECOND_RUN_EXCLUSIVE"
}
]
},
{
"_TransactionID": "availId456movie",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "SRP",
"Money": {
"value": 19.99,
"_currency": "USD"
}
},
{
"_termName": "WSP",
"Money": {
"value": 18.99,
"_currency": "USD"
}
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "Exclusive",
"Boolean": false
},
{
"_termName": "AnnounceDate",
"Event": "2022-05-22T10:00:00Z"
}
]
},
{
"_TransactionID": "availId789movie",
"LicenseType": "POEST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "SRP",
"Money": {
"value": 18.99,
"_currency": "USD"
}
},
{
"_termName": "WSP",
"Money": {
"value": 17.99,
"_currency": "USD"
}
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "Exclusive",
"Boolean": false
},
{
"_termName": "AnnounceDate",
"Event": "2022-05-22T10:00:00Z"
},
{
"_termName": "SuppressionLiftDate",
"Event": "2022-07-24T10:00:00Z"
}
]
}
]
}
}
Beispiel 4: Filmtrailer
{
"avail": {
"ALID": "demoALID",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Supplemental",
"Metadata": {
"TitleInternalAlias": [
"Movie: Trailer"
]
}
}
],
"Transaction": [
{
"_TransactionID": "availId123movietrailer",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2024-12-09T14:00:00Z",
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
}
]
},
{
"_TransactionID": "availId123movietrailer",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2024-12-09T14:00:00Z",
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
}
]
}
]
}
Beispiel 5: Trailer zur TV-Serie
{
"avail": {
"ALID": "demoALID",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Supplemental",
"Metadata": {
"TitleInternalAlias": [
"Title Name - Season 3: Official Final Trailer"
]
}
}
],
"Transaction": [
{
"_TransactionID": "availId123tvtrailer",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2025-09-05T13:00:00Z",
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
}
]
},
{
"_TransactionID": "availId123tvtrailer",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2025-09-05T13:00:00Z",
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
}
]
}
]
}
}
Beispiel 6: Filmpaket mit Rabatt
{
"avail": {
"ALID": "TEST_COLLECTION",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "TEST_COLLECTION",
"WorkType": "Collection",
"Metadata": {
"TitleInternalAlias": [
"TEST COLLECTION (4)"
]
},
"BundleAsset": [
{
"BundledALID": "Bundle_Movie_1"
},
{
"BundledALID": "Bundle_Movie_2"
},
{
"BundledALID": "Bundle_Movie_3"
},
{
"BundledALID": "Bundle_Movie_4"
}
]
}
],
"Transaction": [
{
"_TransactionID": "Bundle_collection_est",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "Max"
},
"Start": "2025-10-18T04:00:00Z",
"End": "2032-11-22T04:59:59.999Z",
"Terms": [
{
"_termName": "Tier",
"Text": "CAT EST",
"Money": {
"_currency": "USD"
}
},
{
"_termName": "SRP",
"Money": {
"value": 44.99,
"_currency": "USD"
}
},
{
"_termName": "CompleteYourBundleDiscountPercentage",
"Number": 20
}
]
}
]
}
}
Beispiel 7: TV-Serien-Bundle
{
"avail": {
"ALID": "Test_TV_Bundle_1",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "TestLicensor"
},
"Asset": [
{
"_contentID": "Test_TV_Bundle_1",
"WorkType": "Series",
"SeriesMetadata": {
"SeriesTitleInternalAlias": [
"TV_Bundle_Test"
],
"NumberOfSeasons": 2
}
}
],
"Transaction": [
{
"_TransactionID": "tv_bundle_series_est",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "Max"
},
"Start": "2025-08-26T04:00:00Z",
"End": "2100-01-01T04:59:59.999Z",
"AssetLanguage": [
{
"value": "EN"
}
],
"Terms": [
{
"_termName": "SRP",
"Money": {
"value": 44.99,
"_currency": "USD"
}
},
{
"_termName": "WSP",
"Money": {
"value": 28.34,
"_currency": "USD"
}
},
{
"_termName": "CompleteYourBundleDiscountPercentage",
"Number": 50
}
]
}
]
}
}
Beispiel 8: Film exkl. Rabatt aus Bundles
{
"avail": {
"ALID": "SKU12345",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "TestLicensor"
},
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "Test1234567"
}
],
"Asset": [
{
"_contentID": "SKU12345",
"WorkType": "Movie",
"Metadata": {
"TitleInternalAlias": [
"Exclude_from_Bundles_Test"
]
}
}
],
"Transaction": [
{
"_TransactionID": "exclude_bundle_uhd_premium",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2025-11-25T05:00:00Z",
"End": "2026-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 12.99,
"_currency": "USD"
}
},
{
"_termName": "ExcludedFromBundleDiscount",
"Boolean": true
}
]
},
{
"_TransactionID": "exclude_bundle_hd_premium",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2025-11-25T05:00:00Z",
"End": "2026-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 12.99,
"_currency": "USD"
}
},
{
"_termName": "ExcludedFromBundleDiscount",
"Boolean": true
}
]
},
{
"_TransactionID": "exclude_bundle_sd_premium",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2025-11-25T05:00:00Z",
"End": "2026-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 12.99,
"_currency": "USD"
}
},
{
"_termName": "ExcludedFromBundleDiscount",
"Boolean": true
}
]
},
{
"_TransactionID": "exclude_bundle_uhd_midtier",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2026-04-07T04:00:00Z",
"End": "2027-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 10.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_hd_midtier",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2026-04-07T04:00:00Z",
"End": "2027-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 10.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_sd_midtier",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2026-04-07T04:00:00Z",
"End": "2027-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 10.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_uhd_catalog",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2027-04-07T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 11.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_hd_catalog",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2027-04-07T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 11.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_sd_catalog",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2027-04-07T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 11.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_uhd_vod_premium",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2025-10-28T04:00:00Z",
"End": "2026-04-27T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "NR",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_hd_vod_premium",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2025-10-28T04:00:00Z",
"End": "2026-04-27T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "NR",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_sd_vod_premium",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2025-10-28T04:00:00Z",
"End": "2026-04-27T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "NR",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_uhd_vod_catalog",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2026-04-27T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "LB",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_hd_vod_catalog",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2026-04-27T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "LB",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_sd_vod_catalog",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2026-04-27T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "LB",
"Money": {
"_currency": "USD"
}
}
]
}
]
}
}
Beispiel 1: Verfügbarkeit von Titeln abrufen
REQUEST
Method: GET
Url: https://partnerapi.primevideo.com/v1/avails/testlicensor/full-extract/demoAlid?territory=US&businessLine=PRIME_SUBSCRIPTION
RESPONSE
StatusCode: 200
Body:
{
"avail": {
"ALID": "demoAlid",
"Asset": [
{
"EpisodeMetadata": {
"EpisodeNumber": {
"Number": 2
},
"SeasonMetadata": {
"NumberOfEpisodes": 77,
"SeasonContentID": "demoALID_For_Season_01",
"SeasonNumber": {
"Number": 1
},
"SeasonTitleInternalAlias": [
"AvailStrikesBack:Season1"
]
},
"SeriesMetadata": {
"NumberOfSeasons": 4,
"SeriesContentID": "demoALID_For_Series",
"SeriesTitleInternalAlias": [
"AvailStrikesBack"
]
},
"TitleInternalAlias": [
"TestTitleName"
]
},
"WorkType": "Episode",
"_contentID": "demoAlid"
}
],
"Licensor": {
"DisplayName": "testlicensor"
},
"Transaction": [
{
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"ContractID": "CPH",
"End": "2029-05-22T10:00:00Z",
"FormatProfile": {
"value": "UHD"
},
"HoldbackLanguage": [
{
"_asset": "subtitle",
"value": "fr-CA"
},
{
"_asset": "audio",
"value": "fr-CA"
}
],
"LicenseRightsDescription": "DAB",
"LicenseType": "SVOD",
"Start": "2023-03-14T09:00:00Z",
"Terms": [
{
"Text": "prime",
"_termName": "ChannelIdentity"
},
{
"Text": "Yes",
"_termName": "Download"
},
{
"Duration": "PT720H",
"_termName": "RentalDuration"
},
{
"Duration": "PT48H",
"_termName": "WatchDuration"
},
{
"Money": {
"_currency": "USD",
"value": 15.99
},
"_termName": "SRP"
},
{
"Boolean": true,
"_termName": "Exclusive"
},
{
"_termName": "ExclusiveAttributes"
}
],
"Territory": [
{
"country": "US"
}
]
}
]
},
"success": true
}
Validate Avails API-Beispiele
Mit der Avails-API können Sie Ihre Verfügbarkeitsfenster auf Fehler testen, bevor Sie sie an die Live-Systeme von Prime Video senden. Dieser Abschnitt enthält Beispiele für Anfragen und Antworten und zeigt, wie Sie Ihre API-Aufrufe strukturieren können, um Fehler frühzeitig in Ihrem Integrationsworkflow zu erkennen.
Beispiel 1: Überprüfen Sie die vollständige Datenverfügbarkeit
REQUEST
Method: POST
Url: https://partnerapi.primevideo.com/v1/avails/testlicensor/full-extract/demoAlid/validate
Body:
{
"avail": {
"ALID": "demoAlid",
"Asset": [
{
"EpisodeMetadata": {
"EpisodeNumber": {
"Number": 2
},
"SeasonMetadata": {
"NumberOfEpisodes": 77,
"SeasonContentID": "demoALID_For_Season_01",
"SeasonNumber": {
"Number": 1
},
"SeasonTitleInternalAlias": [
"AvailStrikesBack:Season1"
]
},
"SeriesMetadata": {
"NumberOfSeasons": 4,
"SeriesContentID": "demoALID_For_Series",
"SeriesTitleInternalAlias": [
"AvailStrikesBack"
]
},
"TitleInternalAlias": [
"TestTitleName"
]
},
"WorkType": "Episode",
"_contentID": "demoAlid"
}
],
"Licensor": {
"DisplayName": "testlicensor"
},
"Transaction": [
{
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"ContractID": "CPH",
"End": "2029-05-22T10:00:00Z",
"FormatProfile": {
"value": "UHD"
},
"HoldbackLanguage": [
{
"_asset": "subtitle",
"value": "fr-CA"
},
{
"_asset": "audio",
"value": "fr-CA"
}
],
"LicenseRightsDescription": "DAB",
"LicenseType": "SVOD",
"Start": "2023-03-14T09:00:00Z",
"Terms": [
{
"Text": "prime",
"_termName": "ChannelIdentity"
},
{
"Text": "Yes",
"_termName": "Download"
},
{
"Duration": "PT720H",
"_termName": "RentalDuration"
},
{
"Duration": "PT48H",
"_termName": "WatchDuration"
},
{
"Money": {
"_currency": "USD",
"value": 15.99
},
"_termName": "SRP"
},
{
"Boolean": true,
"_termName": "Exclusive"
},
{
"_termName": "ExclusiveAttributes"
}
],
"Territory": [
{
"country": "US"
}
]
}
]
}
}
RESPONSE
StatusCode: 200
Body:
{
"success": true,
"validationErrors": []
}
Hilfreiche Referenzen
Sie können ganz einfach unsere Prime Video-APIs nutzen. Detaillierte Informationen zum Onboarding der einzelnen API-Suiten finden Sie im Onboarding-Leitfaden. Bitte beachten Sie, dass der Onboarding-Prozess für die Content API Suite und die Analytics API Suite getrennt ist.
