API-Abruf (Brand Analytics)
Suchbegriffe-Report automatisch per SP-API ziehen – füllt die Matrix ohne Seller-Central-Export.
Monat abrufen
Auch vergangene Monate möglich (ca. 2 Jahre zurück). Der Abruf dauert je nach Report-Größe 5–15 Minuten – Live-Status unten. Der Cron macht das ab jetzt automatisch am Monatsanfang.
Matrix-Abdeckung
Welche Monate sind mit Daten gefüllt (Anzahl Keywords im Snapshot)?
Jul 26 210
Jun 26 218
Mai 26 203
Apr 26 205
Mär 26 204
Feb 26 179
Jan 26 199
Okt 25 189
Sep 25 206
Aug 25 205
API-Abruf-Historie
| Zeitpunkt | Periode | Status | Datensätze | Keywords geschrieben |
|---|---|---|---|---|
| 03.08.2026 04:01 | 07/2026 | ✓ OK | 608.099 | 210 |
| 15.07.2026 04:58 | 10/2025 | ✓ OK | 676.214 | 189 |
| 15.07.2026 04:55 | 08/2025 | ✓ OK | 592.504 | 205 |
| 14.07.2026 14:15 | 09/2025 | ✓ OK | 586.586 | 206 |
| 14.07.2026 14:11 | 06/2026 | ✓ OK | 651.380 | 218 |
| 14.07.2026 14:00 | 06/2026 | ✓ OK | 651.380 | 218 |
| 14.07.2026 13:55 | 08/2025 | ✓ OK | 592.504 | 205 |
| 14.07.2026 13:53 | 05/2026 | ✓ OK | 613.623 | 203 |
| 14.07.2026 13:51 | 01/2026 | ✓ OK | 670.354 | 199 |
| 14.07.2026 13:49 | 04/2026 | ✓ OK | 578.475 | 205 |
| 14.07.2026 13:48 | 03/2026 | ✓ OK | 636.994 | 204 |
| 14.07.2026 13:44 | 02/2026 | ✓ OK | 553.253 | 179 |
Was wird abgerufen & gespeichert?
- Report
GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT(SP-API, Marketplace DE,reportPeriod=MONTH) – dieselbe Datenbasis wie der manuelle „Häufigste Suchbegriffe"-Export aus Seller Central.- Abgerufene Felder pro Suchbegriff
- Suchbegriff · Suchhäufigkeitsrang · die 3 meistgeklickten Produkte als ASIN mit Klick-Anteil (clickShare) und Konversions-Anteil (conversionShare).
- Was gespeichert wird
- Nur Keywords, die bereits in deiner Watchlist stehen (ba_snapshot / ranking_history) – der Rest des Reports wird verworfen.
Gespeichert in
ba_snapshot(Rank, ASIN 1–3, Klick-/Konversionsanteile je Monat) und gespiegelt nachranking_history→ füllt die Matrix, Trends und Saisonalität. Jeder Lauf landet im Import-Log (Modus „api"). - Was die API NICHT liefert
- Markennamen und Produkttitel gibt es nur im manuellen Seller-Central-Export. Für Marken-Ranking, Mitbewerber-Seiten und Kopf-an-Kopf daher weiterhin 1× im Monat die Marken-Exporte hochladen – neue Mitbewerber-Keywords (Discovery) entstehen ebenfalls nur über den manuellen Voll-Export.
- Doppelt importiert?
- Kein Problem – Schreiben per
ON DUPLICATE KEY UPDATE, vorhandene Monate werden sauber aktualisiert statt dupliziert. - Automatik
- Plesk → Geplante Aufgaben:
/opt/plesk/php/8.3/bin/php {DOCROOT}/ba-auto-fetch.phpz.B. am 3. jedes Monats um 04:00 – holt automatisch den letzten abgeschlossenen Monat.