Get an Amazon creator storefront

Try in Playground

Read a public amazon.com/shop/{handle} storefront with profile, idea lists, shoppable photos and videos, trending picks and curations. Pass pageToken to retrieve the next feed page.

GET/v1/amazon/shopx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

urlstringrequiredquery

Public storefront URL (amazon.com/shop/{handle}, extra path segments are ignored).

min 1 chars · max 2048 chars

Examplehttps://www.amazon.com/shop/example

pageTokenstringquery

Token for the next feed page; pass back as pageToken.

Response fields

requestIdstring

Random operational correlation ID.

Upstream attempts, decoded HTML bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable public data was retrieved.

statusenum

success, partial, failed or challenged. Inspect coverage even for HTTP 200.

one of: success, partial

sourceUrlstring

Public www.amazon.com URL that was read.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Complete means this bounded page had no known omissions; warnings name each omission.

coverage.sourcestring

Always public_page.

coverage.completeboolean

False when any warning is present.

coverage.warningsstring[]

Machine-readable omission codes such as lazy_loaded_ranks_omitted or record_limit.

avatarstringnullable

Profile image URL.

isTopCreatorboolean

Whether the Top Creator badge is shown.

namestringnullable

Display name.

descriptionstringnullable

Storefront description.

socialsstring[]

Linked social profile URLs in page order.

up to 50 items

Feed entries: idea lists (title, itemCount) and shoppable photos (title and itemCount null), in page order.

up to 100 items

lists.titlestringnullable

List title; null for shoppable photos.

lists.itemCountintegernullable

Items in the list; null for photos.

lists.imagestringnullable

Cover image; the real list cover, not the pinned badge.

lists.urlstring

Public list or photo URL with the creator tag.

absolute HTTPS URL

Shoppable videos in the feed.

up to 100 items

videos.idstring

32-character video id.

videos.titlestringnullable

Video title (entities decoded).

videos.thumbnailstringnullable

Poster image URL.

videos.asinsstring[]

HTTP	failure.code	Meaning
400	`invalid_request`	Missing, duplicate, unsupported or invalid parameters.
401	`unauthorized`	Missing or invalid service key.
404	`not_found`	Storefront, product, category or seller page not found.
429	`upstream_rate_limited`	Amazon rate limited the request; no automatic retry.
502	`upstream_challenged`	Robot check, sign-in wall or HTTP 503 from Amazon.
502	`unsupported_page` `unsafe_redirect` `response_too_large` `payload_too_complex` `request_limit` `upstream_error`	Bounded retrieval failed or the page did not match the requested entity.
503	`busy`	All worker slots occupied.
504	`timeout`	Deadline exceeded.
200	`partial`	Coverage warnings such as lazy_loaded_ranks_omitted or record_limit.

Code example

curl "https://api.scrapeatlas.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fexample" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fexample",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fexample",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Amazon request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/amazon/shop",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://www.amazon.com/shop/example"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fexample", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fexample"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.amazon.com/shop/example",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 140000,
    "durationMs": 620
  },
  "avatar": "https://m.media-amazon.com/images/I/synthetic._US500_.jpg",
  "isTopCreator": true,
  "name": "Example Creator",
  "description": "synthetic finds",
  "socials": [
    "https://www.tiktok.com/@example"
  ],
  "lists": [
    {
      "title": "autumn fits",
      "itemCount": 196,
      "image": "https://m.media-amazon.com/images/I/synthetic-list._US550_.jpg",
      "url": "https://www.amazon.com/shop/example/list/LIST0000001?tag=example-20"
    }
  ],
  "videos": [
    {
      "id": "0123456789abcdef0123456789abcdef",
      "title": "Unboxing & setup",
      "thumbnail": "https://m.media-amazon.com/images/I/synthetic-video._SX500_.jpg",
      "asins": [
        "B000000003"
      ]
    }
  ],
  "trendingPicks": [
    {
      "url": "https://www.amazon.com/shop/example/getProductDetails/B000000001?showRelatedPost=true",
      "image": "https://m.media-amazon.com/images/I/synthetic-pick._AC_.jpg",
      "price": 19.66,
      "discount": null
    }
  ],
  "curations": [
    {
      "title": "Autumn edit",
      "postCount": 12,
      "image": "https://m.media-amazon.com/images/I/synthetic-curation._US225_.jpg",
      "url": "https://www.amazon.com/shop/example/curation/11111111-2222-3333-4444-555555555555"
    }
  ],
  "pageToken": "amzn1.ideas.LIST0000001_0_2026-09-01T00:00:00.000Z",
  "hasMore": true
}

Missing, duplicate, unsupported or invalid parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": true,
  "status": "success",
  "sourceUrl": "https://example.com/",
  "fetchedAt": "2026-01-01T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": [
      "string"
    ]
  },
  "lists": [
    {
      "title": "string",
      "itemCount": 0,
      "image": "string",
      "url": "https://example.com/"
    }
  ],
  "videos": [
    {
      "id": "string",
      "title": "string",
      "thumbnail": "string",
      "asins": [
        "string"
      ]
    }
  ],
  "pageToken": "string",
  "hasMore": true
}