amazon/
shop

The Amazon Storefront API reads an Amazon creator storefront from its amazon.com/shop URL and returns the creator profile, linked social accounts, idea lists with item counts, curated posts and trending picks with prices.

Amazon Storefront API

Storefront URL input
Idea lists
Curated posts
Trending picks
0.5 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Amazon Storefront

An Amazon storefront is the page a creator in the Amazon Influencer Program keeps on Amazon under its own shop name, where products are grouped into idea lists and curated posts alongside a bio, a profile photo, social links and a row of trending picks. Reading it shows who the creator is, where else they publish, how their recommendations are organized and which products they are pushing right now with current prices.

Amazon Storefront API Features

  • Creator profile and top creator badgename, text and avatar_url give the creator's display name, storefront description and profile photo, and is_top_creator shows whether Amazon marks them as a top creator.
  • Linked social accountssocial_urls lists the TikTok, YouTube, Pinterest and other profiles the creator links from the storefront header.
  • Idea lists with item countslists returns each idea list on the storefront's first page with its title, link, cover image and items_count, the number of products saved in it.
  • Curated postscurations returns the creator's curated posts with title, link, cover image and posts_count, the number of products grouped in each one.
  • Trending picks with pricestrending_picks returns the products the storefront currently highlights, each with its storefront link, image, current price in the marketplace's currency and any discount shown.

Amazon Storefront API Parameters

ParametersRequiredDescription
urlRequiredThe storefront URL of an Amazon creator, in the form https://www.amazon.com/shop/<name>; storefront URLs on other Amazon marketplaces work the same way.

How to Use the Amazon Storefront API

Send one storefront URL to the Amazon Storefront API and read the storefront as a single row.

  1. POST {"url": "https://www.amazon.com/shop/sydneydelrey"} to /v1/amazon/shop.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the storefront from results.items; has_more and results.next_cursor follow the usual paging rules and stay empty for this single row.
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"}'

Amazon Storefront API Use Cases

  • Scout affiliate creators: Compare is_top_creator, the number of idea lists and their items_count across storefronts to shortlist creators who actively curate products in your category.
  • Follow what a creator recommends: Re-read a storefront every week with the Amazon Storefront API and compare list titles, items_count and trending_picks to see which seasonal lists grow and which products move into the spotlight.
  • Connect a storefront to social channels: Use social_urls to link each storefront to the creator's TikTok, YouTube or Pinterest profiles so commerce activity and social reach sit in one record.

Amazon Storefront API Pro Tips

  • Store the marketplace domain with each result, because trending_picks.price is in that marketplace's currency.
  • Key storefronts on id, the storefront name taken from the URL, so repeat Amazon Storefront API reads of the same creator line up.
  • Open a list or curation through its url when you need the individual products; items_count and posts_count tell you how large it is before you do.

Beyond the Amazon Storefront API, use these APIs when you need a different type of public Amazon data.

  • Amazon Best Sellers API — Collect products from public Amazon Best Sellers category URLs with normalized seller, price, reputation, sold-count, media, source, and timestamp fields.
  • Amazon Product Details API — Collect product details from known Amazon URLs with title, description, seller, price, rating, review-count, sold-count, and media fields.
  • Amazon Product Search API — Search a supported Amazon storefront by product phrase and return normalized product, seller, price, rating, review, sold-count, media, and source fields when available.
  • Amazon Reviews API — Collect public product reviews from supported Amazon URLs with text, ratings, author details, product references, timestamps, and media.
  • Amazon Seller Info API — Collect public Amazon seller-profile identity, description, website, rating, feedback, location, source, and collection-time fields from known seller URLs.

Explore other platforms

Combine Amazon data with public data from other supported social platforms.

Amazon Storefront API — FAQ

Amazon Storefront API is a programmatic interface that reads an Amazon creator storefront from its storefront URL. It returns the creator profile, linked social accounts, idea lists, curated posts and trending picks with prices.

Send one storefront URL per request in the form amazon.com/shop/name. Storefronts on other Amazon marketplaces, such as amazon.co.uk/shop/name, are read the same way.

Each request returns the idea lists, curated posts and trending picks shown on the storefront's first page. Every list and curation includes its link and product count, so you can see how large it is and open it directly.

Each trending pick has its storefront product link, product image, current price in the marketplace's currency and the discount label when the storefront shows one.

The Amazon Storefront API reads one storefront per request and charges 0.5 credits. If the storefront does not exist, the task fails and is fully refunded.