AmazonAmazon StorefrontAmazon InfluencerAffiliate-MarketingAPI-Leitfaden

Amazon Storefront API: Creator-Shops, Ideenlisten und Trending Picks auslesen

Lesen Sie einen Amazon-Creator-Storefront mit einem API-Aufruf aus: Profil, verknüpfte Social-Media-Konten, Ideenlisten mit Artikelanzahl, kuratierte Beiträge und Trending Picks mit Preisen, für 0,5 Credits.

SocQAktualisiert am 19. November 20266 Min. Lesezeit

Creator im Amazon-Influencer-Programm betreiben einen Storefront unter amazon.com/shop/<name>. Sie gruppieren Produkte in Ideenlisten und kuratierten Beiträgen, verknüpfen ihre Social-Media-Konten und heben Trending Picks hervor. Für ein Affiliate- oder Influencer-Team beantwortet diese Seite ganz praktische Fragen: wer der Creator ist, wo er sonst noch postet, was er in dieser Saison empfiehlt und wie groß jede Liste ist.

Am 2026-11-17 hat SocQ die Amazon Storefront API ergänzt, die einen Storefront als einen einzigen strukturierten Datensatz liefert. Dieser Leitfaden behandelt die Anfrage, die Felder, den Preis und die Einbindung in einen Workflow zur Creator-Recherche.

Kurze Antwort: Senden Sie eine Storefront-URL in url an POST /v1/amazon/shop. Fragen Sie GET /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist, und lesen Sie dann eine Zeile aus data.results.items mit dem Creator-Profil, social_urls, lists, curations und trending_picks. Jede Anfrage kostet 0,5 Credits ($0,0025).

Was der Endpunkt liefert

1 SocQ-Credit = $0,005.

EndpunktWas er liefertPreis
Amazon Storefront APIEine Zeile pro Storefront: Creator-Name, Beschreibung, Avatar, Top-Creator-Kennzeichen, verknüpfte Social-Media-Profile, Ideenlisten mit Artikelanzahl, kuratierte Beiträge mit Produktanzahl und Trending Picks mit Preisen0,5 Credits ($0,0025) pro Aufruf

Die Zeile umfasst die erste Seite der Listen, kuratierten Beiträge und Trending Picks des Storefronts. Ein Storefront, der nicht existiert, schlägt mit Erstattung fehl, sodass Sie für tote URLs nichts zahlen.

Authentifizierung und asynchroner Aufgabenablauf

Alle SocQ-Anfragen authentifizieren sich mit einem API-Schlüssel. Derselbe Header gilt für das Einreichen, den Aufgabenstatus und den Abruf der Ergebnisse:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Jede Erfassung läuft als Hintergrundaufgabe:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Die Antwort auf das Einreichen enthält data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Wenn status den Wert succeeded hat, enthält die Antwort die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und reicht bis 500; ist has_more true, übergeben Sie results.next_cursor als cursor. Solange eine Aufgabe queued, running oder failed ist, liefert der Endpunkt Aufgabenmetadaten ohne results.

Mit einer optionalen callback_url im Anfragekörper sendet SocQ nach Abschluss der Aufgabe einen POST mit einer Aufgabenzusammenfassung; die Datensätze lesen Sie mit GET /v1/tasks/{task_id}. Eine Zeitüberschreitung auf Client-Seite bricht die Aufgabe nicht ab. Setzen Sie deshalb mit derselben Aufgaben-ID fort, statt für ein Duplikat zu zahlen. 402 bedeutet zu wenige Credits; 429 bedeutet, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.

Einen Storefront anfragen

Die einzige Eingabe ist url, ein Storefront in der Form amazon.com/shop/<name>. Andere Amazon-Marktplätze funktionieren genauso.

curl -X POST "https://api.socq.ai/v1/amazon/shop" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.amazon.com/shop/sydneydelrey"
  }'

Der Endpunkt akzeptiert eine URL pro Anfrage. Um eine Liste von Storefronts auszulesen, reichen Sie eine Aufgabe pro URL ein, speichern jede task_id mit ihrer Eingabe und fragen die Aufgaben unabhängig voneinander ab.

Den Storefront-Datensatz verstehen

Ein gekürztes Ergebnis aus dem Beispiel der Dokumentation sieht so aus:

{
  "id": "sydneydelrey",
  "platform": "amazon",
  "resource": "shop",
  "type": "storefront",
  "url": "https://www.amazon.com/shop/sydneydelrey",
  "name": "sydney del rey",
  "is_top_creator": true,
  "social_urls": [
    "https://vm.tiktok.com/ZTFrowSpg/",
    "https://www.youtube.com/channel/UCWvW1JOQ-nsAinO1jLFgrVA",
    "https://www.pinterest.com/sydneydelrey"
  ],
  "lists": [
    {
      "title": "Holiday home goods",
      "url": "https://www.amazon.com/shop/sydneydelrey/list/XYAIGEFWJGML?tag=sydneybertonc-20",
      "items_count": 107
    }
  ],
  "curations": [
    {
      "title": "f/w fit try ons",
      "url": "https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae",
      "posts_count": 109
    }
  ],
  "trending_picks": [
    {
      "url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FCLQD6BN?showRelatedPost=true&tag_override=sydneybertonc-20",
      "price": 24.99,
      "discount": null
    }
  ]
}

Die Felder, gruppiert nach Verwendungszweck:

  • Identität des Creators: id (der Storefront-Name aus der URL), name, text (die Beschreibung, die der Creator geschrieben hat), avatar_url und is_top_creator, das anzeigt, ob Amazon den Creator als Top-Creator kennzeichnet.
  • Plattformübergreifende Reichweite: social_urls, die auf dem Storefront verknüpften Social-Media-Profile.
  • Katalogstruktur: lists mit title, url, image_url und items_count; curations mit title, url, image_url und posts_count (die Anzahl der Produkte im kuratierten Beitrag).
  • Aktuelle Aktionen: trending_picks mit url, image_url, price in der Währung des Marktplatzes und discount, sofern ein Rabatt angezeigt wird.

Jede Zeile enthält außerdem collected_at, den Zeitpunkt der Erfassung durch SocQ. Preise ändern sich, speichern Sie diesen Zeitstempel deshalb mit jedem Preis, den Sie aufbewahren. Die vollständige Feldtabelle finden Sie in der Dokumentation zu Amazon Storefront.

Wann sich der Endpunkt eignet

Affiliate-Partner finden. is_top_creator, die Anzahl der Listen und das items_count jeder Liste vermitteln schnell, wie aktiv ein Storefront ist, bevor jemand in Ihrem Team ihn überhaupt öffnet.

Verfolgen, was ein Creator empfiehlt. Lesen Sie einen Storefront regelmäßig erneut aus und vergleichen Sie Listentitel, Anzahlen und Trending Picks zwischen den Durchläufen, um zu sehen, was der Creator in dieser Saison bewirbt.

Einen Storefront mit den Social-Media-Konten des Creators verbinden. social_urls liefert die TikTok-, YouTube- oder Pinterest-Profile, die der Creator verlinkt. Geben Sie diese an die Creator-APIs weiter, um öffentliche geschäftliche E-Mail-Adressen zu finden, oder an die Profil-Endpunkte der Plattformen, um Followerzahlen zu erhalten.

Produktrecherche. Trending Picks verweisen auf Produkte. Für vollständige Produktdaten, Bewertungen oder Kategorie-Rankings nutzen Sie die anderen Amazon-Endpunkte von SocQ, etwa die Amazon Product Details API und die Amazon Best Sellers API. Einen Überblick, wie diese im Vergleich zu Amazons eigenen APIs abschneiden, bietet Alternativen zur Amazon Product Advertising API.

Tipps für den Produktivbetrieb

  1. URLs normalisieren. Verwenden Sie pro Creator eine kanonische Form amazon.com/shop/<name>, damit Sie nicht zweimal für denselben Storefront zahlen.
  2. Mit einem Schnappschuss der ersten Seite rechnen. Listen, kuratierte Beiträge und Trending Picks sind die auf der ersten Seite des Storefronts angezeigten. Betrachten Sie Anzahlen als Schnappschuss zum Zeitpunkt collected_at.
  3. Fehler gesondert behandeln. Ein Storefront, der nicht existiert, schlägt mit Erstattung fehl. Markieren Sie ihn als entfernt, statt die Anfrage zu wiederholen.
  4. Einfach budgetieren. Bei 0,5 Credits pro Storefront kosten 1.000 Storefronts 500 Credits, also $2,50.

FAQ

Was ist die Amazon Storefront API?

Ein SocQ-Endpunkt, der einen Amazon-Creator-Storefront (amazon.com/shop/<name>) ausliest und das Creator-Profil, verknüpfte Social-Media-Konten, Ideenlisten, kuratierte Beiträge und Trending Picks als einen strukturierten Datensatz zurückgibt.

Funktioniert sie auch außerhalb von amazon.com?

Ja. Laut Dokumentation funktionieren andere Amazon-Marktplätze genauso: Senden Sie die Storefront-URL des jeweiligen Marktplatzes in url. Preise in trending_picks sind in der Währung dieses Marktplatzes angegeben.

Liefert sie jedes Produkt aus jeder Liste?

Nein. Die Zeile umfasst die erste Seite des Storefronts: Titel, URL, Titelbild und items_count jeder Liste, die Produktanzahl jedes kuratierten Beitrags und die aktuellen Trending Picks. Die einzelnen Listeneinträge werden nicht aufgeklappt.

Zahle ich, wenn der Storefront nicht existiert?

Nein. Ein Storefront, der nicht existiert, schlägt mit Erstattung fehl. Eine erfolgreiche Anfrage kostet 0,5 Credits ($0,0025).

Kann ich mehrere Storefronts in einer Anfrage senden?

Die Anfrage akzeptiert eine einzige url. Reichen Sie eine Aufgabe pro Storefront ein und verfolgen Sie jede task_id.

AMAZON API

Workflow mit einer öffentlichen Amazon-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

Amazon-APIs ansehen