analyze_provider_offers
ChatGPTBeantwortet, welche Verkäufer die ausgewählten, autorisierten Produkte anbieten und wie deren einzelne beobachtete Angebote zu einer nachvollziehbaren Preisreferenz liegen. analysis=presence liefert Anbieterpräsenz mit Angebotsbelegen; analysis=position (Standard) bewertet zusätzlich jedes Angebot gegen die Referenz: Standard ist der gleichgewichtete Angebotsmedian je Produkt, Site, Währung, Zustandsklasse und Erfassung (belastbar ab zwei bekannten Verkäufern); reference=featured_offer nutzt nur bei eindeutiger Quellsemantik das Featured Offer, reference=customer_reference einen eindeutig autorisierten Kundenreferenzpreis, jeweils ohne stillen Ersatz. view=current (Standard) bewertet die jüngste Erfassung je Produkt und Site im Fenster ohne Rückgriff auf ältere Daten; view=history wertet jede Erfassung getrennt aus. Mehrere Angebote desselben Verkäufers bleiben erhalten; Verkäufer werden je Site über den normalisierten Händlernamen gruppiert und sind keine globale Händleridentität. Preise sind beobachtete Artikelpreise ohne Versand. Das Ergebnis ist eine Marktanalyse, keine Preisempfehlung und kein Beleg für Marktvollständigkeit; complete beschreibt nur den bearbeiteten Abfrageumfang. Zu breite Anfragen liefern einen kontrollierten Fehler statt eines gekürzten Ergebnisses.
describe_results_contract
ChatGPTBeschreibt den Außenvertrag der Preis- und Verfügbarkeitsabfrage list_results: Kernfelder, Include-Gruppen (includeExportFields, includeIdentity, includeCustomerData, includeCoverage, includeOrderIds), die optionalen Preisrollen recommendedRetailPrice und regularPrice samt ihren kanonischen Money-Feldern, deren Weglassen bei fehlender oder ungelöster Quelle oder Währung sowie die bestehende unresolved-Darstellung von priceMoney und referencePriceMoney, Filter, Sortierung, Zeitfenster, den opt-in globalScope und timezone. Nutzt dieselbe Vertragsdefinition wie REST /v1/results/capabilities.
download_order_export_file
ChatGPTLädt die Exportdatei einer konkreten Beobachtung als strukturierte MCP-Dateiantwort. Das gemeinsame REST-/MCP-Rohdateilimit für Archivdateien gilt; eine Überschreitung liefert 413 PAYLOAD_TOO_LARGE. Der Inhalt wird als UTF-8 oder Base64 veröffentlicht. In JSON-RPC-Batches gilt zusätzlich das aggregierte Antwortbudget von 64 MiB; jeder folgende Download erhält nur dessen verbleibenden Rest.
download_order_import_file
ChatGPTLädt die Importdatei einer konkreten Beobachtung als strukturierte MCP-Dateiantwort. Das gemeinsame REST-/MCP-Rohdateilimit für Archivdateien gilt; eine Überschreitung liefert 413 PAYLOAD_TOO_LARGE. Der Inhalt wird als UTF-8 oder Base64 veröffentlicht. In JSON-RPC-Batches gilt zusätzlich das aggregierte Antwortbudget von 64 MiB; jeder folgende Download erhält nur dessen verbleibenden Rest.
get_cheapest_merchants
ChatGPTLiefert je Produkt, Site, Währung und Zustandsklasse den Händler mit dem niedrigsten vergleichbaren beobachteten Artikelpreis im angefragten Fenster samt Zeitpunkt und Angebotsbeleg. Das ist keine Aussage über aktuelle Verfügbarkeit oder den günstigsten Gesamtkauf. Gleichstand: jüngster Erfassungszeitpunkt, normalisierter Händler, Result-ID; ein Gleichstand wird ausgewiesen. Ohne bekannten Händler wird kein günstigster Händler erfunden. Mehr als 100 Kombinationen liefern einen kontrollierten Fehler statt einer Kürzung.
get_market_price_position
ChatGPTPositioniert einen optionalen Kandidatenpreis innerhalb aktueller, autorisierter Marktangebote der letzten 24 Stunden. Trennt Produkt, Land, Währung und Site/Marktplatz, benötigt mindestens zwei Anbieter und verwendet auf ausdrückliche Anforderung einen eindeutig autorisierten Kundenreferenzpreis vor dem Marktmedian. Das Ergebnis ist eine Marktanalyse und keine Preisempfehlung.
get_order_detail
ChatGPTLiefert die Detailansicht einer konkreten Beobachtung inklusive Monitoring-, Coverage- und Health-Sicht.
get_price_history
ChatGPTLiefert je Produkt, Site, Währung und Zustandsklasse einen zeitlich aufsteigenden Verlauf der beobachteten Erfassungen im Fenster mit Angebotsanzahl, Anbieteranzahl, Minimum, Median und Maximum der Artikelpreise; optional mit den Einzelangeboten. Keine Interpolation und keine Fortschreibung fehlender Beobachtungen. Mehr als 100 Produkt-/Site-/Währungs-/Zustandskombinationen oder zu große Ausgaben liefern einen kontrollierten Fehler statt einer Kürzung.
list_asin_locales
ChatGPTLiefert die im aktuellen Sichtbarkeitskontext unterstützten asinLocale-Werte für Produkt- und Preisabfragen.
list_items
ChatGPTZeigt Produkte ausschließlich im aktuellen, autorisierten Sichtbarkeitskontext des Accounts. Jeder Account ist begrenzt; wie viele Items sichtbar sind, hängt vom gebuchten Paket-/Leistungsumfang und vom gewählten Beobachtungs- und Filterumfang des Kunden oder Agenten ab. list_items ist keine Abfrage des vollständigen PREISmonitoring-Bestands; eine kleine oder leere Trefferliste beweist nicht, dass ein Produkt generell nicht existiert oder nicht beobachtet wird. Der Aufruf erweitert den Account-Scope nicht. Unterstützt exakte Identifier sowie kombinierbare Filter für Freitext, Marke, Kategorie, Beobachtung und Shop/Plattform. Ein exakter Identifier (itemId, pzn, ean oder asinLocale zusammen mit asin) begrenzt nur die Kandidatenmenge; text, brand, category, orderId und site bleiben Residualprädikate und können den Identifier-Treffer entfernen. Ein nicht passender Zusatzfilter liefert daher regulär eine leere gefilterte Antwort. Sobald mindestens ein solcher Filter oder discoverCategories gesetzt ist, enthält die schlanke Trefferform einen search-Block sowie itemId, displayName, categories und die vorhandenen Identifier ean, pzn und asin. Aufrufe ohne Filter und ohne Discovery behalten die vollständige ungefilterte Item-Form; das gilt auch für einen reinen Identifier-Aufruf. Kategorien sind kundenspezifisch und werden normalisiert, ohne interne Feldnamen offenzulegen. Jeder Account sieht ausschließlich Kategorien aus seinen eigenen sichtbaren Kundenzuordnungen. discoverCategories liefert pro Seite ausschließlich die Kategorien der tatsächlich zurückgegebenen sichtbaren Produkte; Clients bilden die Vereinigungsmenge über alle per paging.nextCursor verbundenen Seiten. search.availableCategoriesComplete=true bedeutet, dass diese seitenübergreifend gesammelte Menge mit der aktuellen Seite vollständig ist. Sind keine nutzbaren Kategorien sichtbar, bleibt reine Discovery erfolgreich und liefert eine leere Liste. search.categoryResolutionScope=visibleCustomerData bedeutet: In eingeschränkten Kontexten werden Kategorien und customerData ausschließlich aus dem serverseitig erlaubten Kundenausschnitt projiziert. Sind keine erlaubten Kundendaten verfügbar, bleibt der customerData-Ausschnitt leer; der bestehende unrestricted-Leseweg behält seinen vollständigen Ausschnitt. Jeder Account sieht damit nur Daten aus seinem erlaubten sichtbaren Kundenausschnitt. ITEM_CATEGORY_NOT_AVAILABLE bleibt auf einen expliziten category-Filter begrenzt und bedeutet nur, dass im abschließend bearbeiteten Segment keine sichtbare Kategorie auflösbar ist, nicht dass das Produkt generell keine Kategorie besitzt; bereits auf früheren Seiten gesammelte Kategorien bleiben gültig. Die Markenabdeckung im Bestand ist gering (ca. 8,5 %); ein leerer Markenfilter-Treffer bedeutet daher nicht zwingend, dass das Produkt nicht beobachtet wird. Suchfilter sind in unrestricted-Kontexten ohne indexierten Suchpfad nicht verfügbar und liefern ITEM_SEARCH_UNAVAILABLE; eine nicht autorisierte itemId, orderId oder site liefert AUTH_SCOPE_DENIED, ohne die Existenz der Ressource zu bestätigen oder zu widerlegen. Bei einer gefilterten Seite mit returned < limit sind drei Fälle unterscheidbar: paging.nextCursor vorhanden plus search.scanBudgetTruncated=true bedeutet Budget-Erschöpfung; Cursor vorhanden plus search.deadlineTruncated=true bedeutet erreichte Zeitschranke; kein Cursor und beide Flags false bedeutet das echte Ende der Treffermenge. Clients müssen paging.nextCursor folgen, solange er vorhanden ist. itemId aus einem Treffer kann unverändert für list_results und get_market_price_position verwendet werden. displayName folgt derselben durchsuchbaren Fallback-Kette aus sichtbaren kundenbezogenen Produktnamen und -titeln, lokalisierten Namen sowie Identifier-Ersatzwerten wie der Freitextfilter.
list_order_export_history
ChatGPTLiefert die sichtbare Export-Historie einer konkreten Beobachtung.
list_order_exports
ChatGPTLiefert die sichtbaren Exportaufträge zu einer konkreten Beobachtung.
list_order_import_history
ChatGPTLiefert die sichtbare Import-Historie einer konkreten Beobachtung.
list_order_imports
ChatGPTLiefert die sichtbaren Importaufträge zu einer konkreten Beobachtung.
list_order_observation_quality
ChatGPTLiefert den aktuellen, paginierten Reporter-Snapshot je Produkt und Site. Technische Wiederholungsversuche erhöhen die Beobachtungszahlen nicht. PRODUCT_NOT_FOUND ist eine reguläre negative Marktbeobachtung und kann für die Sortimentstiefe eines Shops wertvoll sein; es ist für sich kein API-, Crawler-, Shop-, Provider- oder Systemfehler. Ein Qualitätsfehler liegt nur als False Negative vor, wenn das Produkt zum Beobachtungszeitpunkt tatsächlich vorhanden war, aber fälschlich als fehlend klassifiziert wurde. Die API meldet die beobachtete Klassifikation und kann ein False Negative ohne externe Ground Truth nicht beweisen.
list_orders
ChatGPTLiefert die sichtbaren Beobachtungen. Eine Beobachtung beschreibt, welche Produkte in welchem Beobachtungszuschnitt überwacht werden. Monitoring und Coverage können explizit angefordert werden.
list_results
ChatGPTLiefert Preis- und Verfügbarkeitsdaten für sichtbare Produkte im aktuellen Beobachtungskontext. Unterstützt orderId, itemId, pzn, ean, asinLocale plus asin, site, globalScope, coverageState, capturedFrom, capturedTo, sort, timezone, latestPerPair, includeCoverage, includeOrderIds, includeCustomerData, includeExportFields, includeIdentity und cursor. includeExportFields=true kann zusätzlich die getrennten optionalen Preisrollen recommendedRetailPrice und regularPrice in Minor Units sowie recommendedRetailPriceMoney und regularPriceMoney im kanonischen Geldformat liefern; fehlende oder nicht auflösbare Rollen werden weggelassen und nicht aus price oder Kundenreferenzpreisen abgeleitet. priceMoney und referencePriceMoney behalten ihre bestehende unresolved-Darstellung. Produktbezogene Reads ohne capturedFrom und capturedTo verwenden ein 168-Stunden-Fenster; sobald eine Grenze gesetzt ist, bleibt sie explizit. Ein capturedFrom/capturedTo-Zeitfenster erfordert weiterhin einen Scope, außer globalScope=true wird ausdrücklich gesetzt. GlobalScope benötigt beide Grenzen, keinen Produkt-/Order-/Site-Scope und höchstens 168 Stunden. Prüfen Sie bei „älteste Results“ vor dem Aufruf drei Lesarten: globale erste Ereignisse im gewählten Scope, die älteste aktuell sichtbare Beobachtung je Item-Shop-Paar oder ein bestimmtes Zeitfenster. Ist die Sicht unklar, fragen Sie nach und behaupten Sie keine globale Vollständigkeit. cursor lädt die nächste Results-Seite, aber erst nach einer erfolgreich akzeptierten Seite. RESULTS_SCOPE_TOO_BROAD wird vor der ersten Seite abgelehnt: Starten Sie dann eine neue Anfrage mit engerem Scope und/oder Zeitfenster; bei globalScope=true verkleinern Sie beide Grenzen oder entfernen Sie den globalen Scope für eine Anfrage mit Identifier- oder Site-Scope. Ein cursor oder der Stream kann diese erste Ablehnung nicht umgehen.
list_sites
ChatGPTLiefert die im aktuellen Sichtbarkeitskontext beobachteten Shops und Plattformen.
rank_price_volatility
ChatGPTRankt Produkte nach der beobachteten absoluten oder relativen Preisspanne einer konsistenten Referenzzeitreihe (Angebotsmedian oder Featured Offer je Erfassung) über mindestens zwei Erfassungszeitpunkte. Relativ: 100 × (Maximum − Minimum) / Minimum. Es ist weder eine Standardabweichung noch die Spannweite gleichzeitig angebotener Händlerpreise; Änderungen der Angebotszusammensetzung können den Median verändern. Die Rangliste wird je Site und Währung getrennt berechnet und ausgegeben (eigener Rang je Gruppe, limit gilt je Gruppe); Sortierung: gewählte Schwankung, die andere Schwankung, Item-ID.
submit_inquiry
ChatGPTÜbermittelt eine unverbindliche Anfrage zu Preis- oder Verfügbarkeitsmonitoring. Die Angaben helfen, den fachlichen Bedarf einzuordnen: itemCount, sourceCount und Zeiträume dürfen Schätzwerte sein; wenn etwas noch nicht bekannt ist, lassen Sie das Feld weg und beschreiben Sie Unsicherheit bei Bedarf in purpose oder details, statt einen falschen Nullwert zu setzen. contact.name und contact.email sind die Kontaktdaten der anfragenden Person; phone und mobile sind optional. Ein optionaler agent kann einen beauftragten technischen oder fachlichen Vermittler beschreiben, dessen E-Mail-Adresse von der E-Mail der anfragenden Person getrennt bleibt; für replyTo=agent ist sie erforderlich. Bestätigen Sie, dass Sie zur Anfrage berechtigt sind. Übermitteln Sie niemals Passwörter, API-Schlüssel oder andere Zugangsdaten. Für die Validierung wird führender und nachfolgender Leerraum (Whitespace, etwa Leerzeichen, Tabulatoren und Zeilenumbrüche) ausgeblendet. Der so geprüfte Text muss nichtleer und einzeilig sein; Zeilenumbrüche, Tabulatoren und andere Steuerzeichen im so geprüften Text werden abgelehnt. Die Längengrenzen gelten in UTF-8-Bytes für diesen geprüften Text; Umlaute und andere Nicht-ASCII-Zeichen belegen mehrere Bytes, sodass die Grenze vor der genannten Zeichenzahl erreicht sein kann. requestId ist eine wiederverwendbare UUID: Bei unklarem Ausgang (INQUIRY_UNCERTAIN oder Abbruch der Verbindung) kann die Anfrage bereits eingegangen sein; senden Sie dann nicht automatisch erneut, auch nicht mit einer neuen UUID. Eine Wiederholung mit derselben UUID und denselben Angaben wird nur nach bestem Bemühen erkannt: zeitlich und mengenmäßig begrenzt, nur innerhalb derselben Serverinstanz und nicht über Neustarts hinweg. Es gibt keinen Abfrageweg für den Abschlussstatus. Die Antwort enthält nur eine neutrale Referenz und den Bearbeitungsstatus.