Mit der Angebotsstatus-API können Sie überprüfen, ob Ihre Titel in der Prime-Video-Storefront verfügbar sind – und wenn nicht, warum. Zentralisieren Sie Ihre Katalogdaten in Ihren eigenen Systemen, anstatt Slate oder die Storefront manuell zu überprüfen. So erhalten Sie in Echtzeit einen Überblick über alle Ihre Geschäftsbereiche und Gebiete.
Warum sollten Sie die Angebotsstatus-API verwenden?
- Zentralisierter Betrieb – Ziehen Sie Katalogdaten direkt in Ihre eigenen Systeme zusammen mit Ihren anderen Vertriebskanälen. Sie müssen sich nicht für jede Statusüberprüfung bei Slate anmelden
- Schnellere Problemlösung – Erkennen Sie sofort Verfügbarkeitsprobleme und finden Sie heraus, was Ihre Titel daran hindert, live zu gehen, wodurch die Lösungszeit um bis zu 3 Tage reduziert wird
- Proaktives Katalogmanagement – Überwachen Sie Ihren gesamten Katalog programmatisch für alle Gebiete und Angebotstypen, sodass Sie Ihre Abläufe skalieren können, wenn Ihr Unternehmen wächst
- Startüberprüfung in Echtzeit – Erfahren Sie sofort, wann Ihre Inhalte erfolgreich veröffentlicht wurden, ohne dass Sie die Storefront manuell überprüfen oder auf Statusaktualisierungen warten müssen
Anfrage- und Antwortschemas
Dieser Abschnitt enthält technische Spezifikationen für Entwickelnde zur Integration der Angebotsstatus-API in ihre Systeme. Verwenden Sie diese Referenz, um das Abfrageformat, die Antwortstruktur und die von der API zurückgegebenen Datentypen zu verstehen.
Anfrageformat
Die Angebotsstatus-API verwendet eine einfache Abruffunktion über die GET-Anfragestruktur, bei der alle Anfrageparameter über die URL übergeben werden – es ist kein Anfragetext erforderlich. Dies erleichtert die Integration in Ihre Systeme und das Testen mit Standard-HTTP-Clients oder Befehlszeilen-Tools. Erstellen Sie einfach die URL mit Ihrer Titelkennzeichnung und optionalen Filtern und senden Sie dann eine GET-Anfrage, um den aktuellen Status Ihrer Angebote abzurufen:
https://partnerapi.primevideo.com/v1/avails/{liscensor}/status/{ALID}?marketplace={Amazon Marketplace}&territory={territory}
Parameter
Diese Tabelle definiert die Parameter, die Sie zum Abfragen von Angebotsstatusinformationen verwenden können.
Parameter |
Typ |
Ist verpflichtend |
Beschreibung |
Lizenzgeber |
Zeichenfolge |
Ja |
Ihre Organisationskennung, die von Prime Video beim Onboarding bereitgestellt wurde |
ALID |
Zeichenfolge |
Ja |
Titelkennung (ALID oder SKU), die zu Ihrem Beitrag passt |
Marketplace |
Zeichenfolge |
Nein |
Der Amazon Marketplace, bei dem der Titel eingereicht wurde. Dies ist standardmäßig GLOBAL und muss nicht angegeben werden. |
Gebiet |
Zeichenfolge |
Nein |
Zweibuchstabiger Gebietscode (z. B. US, GB, AU), mit dem Sie den Angebotsstatus überprüfen möchten. Dies ist standardmäßig auf alle Gebiete voreingestellt und muss nicht angegeben werden. Alle Angebotsstatus werden zurückgegeben, wenn dies nicht angegeben wird |
Beispielanfragen
https://partnerapi.primevideo.com/v1/avails/mgm/status/skuabc123?marketplace=global&territory=US
https://partnerapi.primevideo.com/v1/avails/mgm/status/skuabc123?marketplace=global
https://partnerapi.primevideo.com/v1/avails/mgm/status/skuabc123
Hinweis: Je spezifischer Ihre Anfrageparameter sind, desto zielgerichteter wird Ihre Antwort sein. Wenn Sie optionale Parameter wie Marketplace und Gebiet weglassen, gibt die API Statusinformationen für alle zutreffenden Bereiche zurück, die dieser ALID zugeordnet sind.
Antwortschema
Das Antwortschema definiert die Struktur der Daten, die von der Angebotsstatus-API zurückgegeben werden. Wenn Sie diese Datentypen verstehen, können Sie die Antwort analysieren und Statusinformationen effektiv in Ihre Systeme integrieren.
Statusantwort abrufen
Die Antwort auf oberster Ebene, die Informationen zum Angebotsstatus für den angeforderten Titel enthält. Jede Antwort enthält Statusdaten, die nach Ihren Anfrageparametern gefiltert wurden, sodass Sie den Verfügbarkeitsstatus in verschiedenen Geschäftsbereichen und Gebieten nachvollziehen können.
Attribut |
Typ |
Ist verpflichtend |
Beschreibung |
OfferStatuses |
OfferStatus[] |
Ja |
Reihe von Angebotsstatusobjekten, eines pro Geltungsbereich (Kombination aus Geschäftsbereich/Gebiet) |
Fehler |
Zeichenfolge |
Nein |
Liste der Fehler im Fehlerfall |
Angebotsstatustyp Die Kerndatenstruktur, die den Status eines einzelnen Angebots darstellt. Dazu gehören allgemeine Statusinformationen und detaillierte Daten auf Transaktionsebene für jedes Verfügbarkeitsfenster.
Attribut |
Typ |
Ist verpflichtend |
Beschreibung |
ALID |
Zeichenfolge |
Ja |
Titel-ID, die Ihrem Metadatenbeitrag entspricht |
GroupingEntity |
Zeichenfolge |
Abhängig |
Kennung für einen Channel oder ein Abonnement (erforderlich für SVOD-Angebote) |
Lizenzgeber |
Herausgeber |
Ja |
Informationen über Ihre Organisation, die Prime Video eine Lizenz gewährt |
OverallStatus |
Status |
Ja |
Gesamtstatus für alle Fenster im aktuellen Avail-Kontext/-Umfang |
PlatformID |
Zeichenfolge[] |
Ja |
Liste der Global Title Identifiers (GTI) für einen Titel |
Transaktion |
Transaktion[] |
Ja |
Eine Liste der Verfügbarkeitsfenster und ihrer Status |
Art des Herausgebers
Identifiziert Ihre Organisation als Inhaltslizenzgeber. Dieser Wert wird von Prime Video beim Onboarding bereitgestellt.
Attribut |
Typ |
Erforderlich |
Hinweise |
DisplayName |
Zeichenfolge |
Ja |
Anzeigename Ihrer Organisation |
OrganizationID |
Zeichenfolge |
Ja |
Ihre Organisationskennung, die Prime Video beim Onboarding angegeben hat (muss mit dem in Avails verwendeten Wert übereinstimmen) |
Statustyp
Stellt die allgemeinen Statusinformationen für das Angebot bereit, einschließlich des Datumsbereichs und des aktuellen Fortschrittscodes.
Attribut |
Typ |
Erforderlich |
Hinweise |
Kommentare |
Zeichenfolge |
Nein |
Für Menschen lesbare Notizen von Amazon (derzeit null) |
Start |
Datum |
Ja |
Frühestes Startdatum des Fensters für den Kontext |
Ende |
Datum |
Ja |
Spätestes Enddatum des Fensters für den Kontext. |
Fortschrittscode |
ENUM |
Ja |
Fortschrittscode für den Kontext |
_Zeitstempel |
Datum |
Ja |
Das letzte Mal, als sich der Status geändert hat oder aktualisiert wurde |
Transaktionstyp
Stellt ein einzelnes Verfügbarkeitsfenster mit den zugehörigen Lizenzbedingungen und dem zugehörigen Status dar. Jede Transaktion entspricht einer bestimmten Kombination aus Lizenztyp, Gebiet und Formatprofil.
Attribut |
Typ |
Erforderlich |
Hinweise |
ContractID |
Zeichenfolge |
Ja |
Vertrag, mit dem der Titel verknüpft ist |
FeatureStatus |
FeatureStatus |
Ja |
Status für das Fenster |
Ende |
Datum |
Ja |
Spätestes Enddatum des Fensters für den Kontext |
Fortschrittscode |
ENUM |
Ja |
Fortschrittscode für den Kontext |
_Zeitstempel |
Datum |
Ja |
Das letzte Mal, als sich der Status geändert hat oder aktualisiert wurde |
FormatProfile |
FormatProfile[] |
Ja |
Qualität des verfügbaren Videos. Zulässige Werte: SD, HD, UHD, MAX |
LicenseType |
Enum |
Ja |
Zulässige Werte: SVOD, FVOD, EST, POEST, VOD |
Gebiet |
Zeichenfolge[] |
Ja |
Gebiet für das Fenster |
TransactionID |
Zeichenfolge |
Nein |
Demnächst – wird die AvailID mit Teilextrakten übergeben (derzeit null). |
FeatureStatus-Typ
Enthält detaillierte Statusinformationen für ein bestimmtes Verfügbarkeitsfenster, einschließlich des Datumsbereichs und des Fortschrittscodes.
Attribut |
Typ |
Erforderlich |
Hinweise |
Kommentare |
Zeichenfolge |
Nein |
Für Menschen lesbare Notizen von Amazon (derzeit null) |
Start |
Datum |
Ja |
Startdatum des Fensters |
Ende |
Datum |
Ja |
Enddatum des Fensters |
Fortschrittscode |
ENUM |
Ja |
Fortschrittscode für das Fenster (derzeit Null – verwenden Sie OverallStatus, um festzustellen, ob der Kontext live ist) |
_Zeitstempel |
Datum |
Ja |
Das letzte Mal, als sich der Status geändert hat oder aktualisiert wurde |
FormatProfile-Typ
Gibt die Videoqualitätsstufe für die Verfügbarkeit an. In einer einzigen Transaktion können mehrere Formatprofile enthalten sein, wenn Sie Ihre Inhalte in mehreren Qualitätsstufen (z. B. sowohl HD als auch UHD) verwendet haben.
Attribut |
Typ |
Erforderlich |
Hinweise |
value[] |
Enum |
Ja |
Qualität des verfügbaren Videos. Zulässige Werte: SD, HD, UHD, MAX |
Hinweis: Die obigen Schemas stellen die aktuelle API-Antwortstruktur dar. Einige Felder (wie Comments, ProgressCode in FeatureStatus und TransactionID) sind derzeit leer, können aber in zukünftigen Versionen gefüllt werden.
Beispiel für eine Antwort
Dieses Beispiel zeigt eine typische API-Antwort für einen SVOD-Titel mit mehreren Verfügbarkeitsfenstern in verschiedenen Gebieten. Die Antwort zeigt, wie Statusinformationen strukturiert sind, einschließlich des Gesamtstatus, der Transaktionsdetails und der Formatprofile.
SVOD-Beispiel:
[
{
"__type": "OfferStatus:http://internal.amazon.com/coral/com.amazon.pvpartnerapiofferstatusresourceserver/",
"ALID": "1ceMergeSeries5",
"GroupingEntity": null,
"Licensor": {
"DisplayName": "prodtest",
"OrganizationID": "prodtest"
},
"OverallStatus": {
"Comments": null,
"End": "2026-12-16T14:20:45Z",
"ProgressCode": "Live",
"Start": "2024-07-26T14:20:45Z",
"_timestamp": "2025-12-19T01:41:06.042Z"
},
"PlatformID": [
"amzn1.dv.gti.0d78e450-d295-4d6e-bf6e-b47af334bad0"
],
"Transaction": [
{
"ContractID": "PTG07",
"FeatureStatus": {
"Comments": null,
"End": "2026-12-16T14:20:45Z",
"ProgressCode": null,
"Start": "2024-07-26T14:20:45Z",
"_timestamp": "2025-12-19T01:41:06.042Z"
},
"FormatProfile": [
"MAX"
],
"LicenseType": "EST",
"PlatformLRD": null,
"Territory": [
"AU"
],
"TransactionID": [],
"_timestamp": "2025-12-19T01:41:06.042Z"
}
]
},
{
"__type": "OfferStatus:http://internal.amazon.com/coral/com.amazon.pvpartnerapiofferstatusresourceserver/",
"ALID": "1ceMergeSeries5",
"GroupingEntity": null,
"Licensor": {
"DisplayName": "prodtest",
"OrganizationID": "prodtest"
},
"OverallStatus": {
"Comments": null,
"End": "2026-12-16T14:20:45Z",
"ProgressCode": "Ready",
"Start": "2024-07-26T14:20:45Z",
"_timestamp": "2025-12-19T12:57:50.949Z"
},
"PlatformID": [
"amzn1.dv.gti.0d78e450-d295-4d6e-bf6e-b47af334bad0"
],
"Transaction": [
{
"ContractID": "PDTST",
"FeatureStatus": {
"Comments": null,
"End": "2026-12-16T14:20:45Z",
"ProgressCode": null,
"Start": "2024-07-26T14:20:45Z",
"_timestamp": "2025-12-19T12:57:50.949Z"
},
"FormatProfile": [
"MAX"
],
"LicenseType": "EST",
"PlatformLRD": null,
"Territory": [
"US"
],
"TransactionID": [],
"_timestamp": "2025-12-19T12:57:50.949Z"
}
]
}
]
Häufig gestellte Fragen
Die folgenden Abschnitte enthalten Antworten auf häufig gestellte Fragen zur Arbeit mit der Angebotsstatus-API.