Amazon Storefront API
curl --request POST \
--url https://api.socq.ai/v1/amazon/shop \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/amazon/shop"
payload = {
"url": "<string>",
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: '<string>', callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/amazon/shop', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/amazon/shop",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'url' => '<string>',
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/amazon/shop"
payload := strings.NewReader("{\n \"url\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/amazon/shop")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"url\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/amazon/shop")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"url\": \"<string>\",\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Amazon
Amazon Storefront
Get an Amazon creator storefront: profile, idea lists, curated posts and trending picks.
POST
/
v1
/
amazon
/
shop
Amazon Storefront API
curl --request POST \
--url https://api.socq.ai/v1/amazon/shop \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/amazon/shop"
payload = {
"url": "<string>",
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: '<string>', callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/amazon/shop', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/amazon/shop",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'url' => '<string>',
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/amazon/shop"
payload := strings.NewReader("{\n \"url\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/amazon/shop")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"url\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/amazon/shop")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"url\": \"<string>\",\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Amazon Storefront
Creators in the Amazon Influencer Program run a storefront at amazon.com/shop/name where they group products into idea lists and curated posts. Read one storefront to see who the creator is, which social accounts they link, how their lists are organized and how many products each holds, and which items the storefront currently pushes as trending picks, with prices. Useful for scouting affiliate partners or following what a creator recommends this season.{
"url": "https://www.amazon.com/shop/sydneydelrey"
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | Storefront name from the URL, used as the identifier. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | URL of the Amazon storefront. |
published_at | string | Yes | Time the source item was published, in ISO 8601 format when available. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
name | string | Yes | Display name of the creator. |
text | string | Yes | Storefront description written by the creator. |
avatar_url | string | Yes | URL of the creator’s profile photo. |
is_top_creator | boolean | Yes | Whether Amazon marks the creator as a top creator. |
social_urls | array<string> | Yes | Links to the creator’s social profiles shown on the storefront. |
lists | array<object> | Yes | Idea lists on the storefront, as shown on its first page. |
lists.title | string | Yes | Title of the list. |
lists.url | string | Yes | URL of the list. |
lists.image_url | string | Yes | URL of the list’s cover image. |
lists.items_count | integer | Yes | Number of products in the list. |
curations | array<object> | Yes | Curated posts on the storefront, each grouping several products. |
curations.title | string | Yes | Title of the curated post. |
curations.url | string | Yes | URL of the curated post. |
curations.image_url | string | Yes | URL of the curated post’s cover image. |
curations.posts_count | integer | Yes | Number of products in the curated post. |
trending_picks | array<object> | Yes | Products the storefront currently highlights as trending. |
trending_picks.url | string | Yes | URL of the product on the storefront. |
trending_picks.image_url | string | Yes | URL of the product image. |
trending_picks.price | number | Yes | Current price of the product in the marketplace’s currency. |
trending_picks.discount | string | Yes | Discount shown for the product, when any. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-amazon-shop",
"status": "succeeded",
"public_id": "amazon/shop",
"result_count": 1,
"credits_amount": 0.5,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "storefront",
"schema_version": "1.0",
"items": [
{
"id": "sydneydelrey",
"platform": "amazon",
"resource": "shop",
"type": "storefront",
"url": "https://www.amazon.com/shop/sydneydelrey",
"published_at": null,
"collected_at": "2026-11-17T23:54:07.629296Z",
"name": "sydney del rey",
"text": "sharing all of my favorite Amazon finds ᥫ᭡ click the icons below to follow me on socials! all photo & video content is also shoppable x",
"avatar_url": "https://m.media-amazon.com/images/I/71D+tmgGHHL._CR0%2C0%2C972%2C972_._US500_SCLZZZZZZZ_.jpg",
"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",
"image_url": "https://m.media-amazon.com/images/G/01/Influencer/full_bleed_pin_2x.png",
"items_count": 107
},
{
"title": "thanksgiving fitspo",
"url": "https://www.amazon.com/shop/sydneydelrey/list/35KWG9X334D4Q?tag=sydneybertonc-20",
"image_url": "https://m.media-amazon.com/images/G/01/Influencer/full_bleed_pin_2x.png",
"items_count": 199
},
{
"title": "my amazon boot collection",
"url": "https://www.amazon.com/shop/sydneydelrey/list/3C0MB7YWND2K7?tag=sydneybertonc-20",
"image_url": "https://m.media-amazon.com/images/G/01/Influencer/full_bleed_pin_2x.png",
"items_count": 60
}
],
"curations": [
{
"title": "SHOES ✨",
"url": "https://www.amazon.com/shop/sydneydelrey/curation/bdca11e0-6920-4402-ac72-2f2016ed1e36",
"image_url": "https://m.media-amazon.com/images/I/31WrBrxRKAL._US225_SCLZZZZZZZ_.jpg",
"posts_count": 14
},
{
"title": "f/w fit try ons",
"url": "https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae",
"image_url": "https://m.media-amazon.com/images/S/shoppable-media-external-prod-iad-us-east-1/8d48ee6a-0c49-4441-b385-a50fb9d86618/3254e-2233-46c9-89bd-434412530._SX225_SCLZZZZZZZ_.jpeg",
"posts_count": 109
},
{
"title": "fall by category 🍂",
"url": "https://www.amazon.com/shop/sydneydelrey/curation/7e16f5d6-99a7-4277-b498-caffddd25cd5",
"image_url": "https://m.media-amazon.com/images/I/41gq2G5kbDL._US225_SCLZZZZZZZ_.jpg",
"posts_count": 12
}
],
"trending_picks": [
{
"url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FCLQD6BN?showRelatedPost=true&tag_override=sydneybertonc-20",
"image_url": "https://m.media-amazon.com/images/I/41pf3SeQpRL._AC_.jpg",
"price": 24.99,
"discount": null
},
{
"url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0H7JQ63LX?showRelatedPost=true&tag_override=sydneybertonc-20",
"image_url": "https://m.media-amazon.com/images/I/312BjBBJwiL._AC_.jpg",
"price": 19.97,
"discount": null
},
{
"url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FS2G449L?showRelatedPost=true&tag_override=sydneybertonc-20",
"image_url": "https://m.media-amazon.com/images/I/41hQG+UyrFL._AC_.jpg",
"price": 27.13,
"discount": null
}
]
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide the storefront URL of an Amazon creator in url. The result is one row with the storefront profile, its idea lists, curations and trending picks.
Amazon storefront URL, such as https://www.amazon.com/shop/sydneydelrey.
Minimum string length:
1
