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
urlanPOST /v1/amazon/shop. Fragen SieGET /v1/tasks/{task_id}ab, bis die Aufgabe erfolgreich ist, und lesen Sie dann eine Zeile ausdata.results.itemsmit dem Creator-Profil,social_urls,lists,curationsundtrending_picks. Jede Anfrage kostet 0,5 Credits ($0,0025).
Was der Endpunkt liefert
1 SocQ-Credit = $0,005.
| Endpunkt | Was er liefert | Preis |
|---|---|---|
| Amazon Storefront API | Eine 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 Preisen | 0,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_urlundis_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:
listsmittitle,url,image_urlunditems_count;curationsmittitle,url,image_urlundposts_count(die Anzahl der Produkte im kuratierten Beitrag). - Aktuelle Aktionen:
trending_picksmiturl,image_url,pricein der Währung des Marktplatzes unddiscount, 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
- URLs normalisieren. Verwenden Sie pro Creator eine kanonische Form
amazon.com/shop/<name>, damit Sie nicht zweimal für denselben Storefront zahlen. - 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. - Fehler gesondert behandeln. Ein Storefront, der nicht existiert, schlägt mit Erstattung fehl. Markieren Sie ihn als entfernt, statt die Anfrage zu wiederholen.
- 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