Creator Shop

GET/v1/amazon/shop1 credit

Returns an Amazon influencer storefront: the creator's profile and social links, their idea lists, shoppable videos, trending picks and curations, with paging through the rest of the lists and videos.

01Query parameters

Name	Type	Description
urlrequired	string	Storefront URL, e.g. `https://www.amazon.com/shop/sydneydelrey`.
pageTokenoptional	string	The `pageToken` value of the previous answer for the same shop, to get the next page.

02Request

curl "https://api.scrapesocial.ai/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fsydneydelrey" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fsydneydelrey

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "avatar": "https://m.media-amazon.com/images/I/71D+tmgGHHL._CR0%2C0%2C972%2C972_._US500_SCLZZZZZZZ_.jpg",
  "isTopCreator": true,
  "name": "sydney del rey",
  "description": "sharing all of my favorite Amazon finds ᥫ᭡ click the icons below to follow me on socials! all photo & video content is also shoppable x",
  "socials": [
    "https://vm.tiktok.com/ZTFrowSpg/",
    "https://www.youtube.com/channel/UCWvW1JOQ-nsAinO1jLFgrVA"
  ],
  "lists": [
    {
      "title": "thanksgiving fitspo",
      "itemCount": 195,
      "image": "https://m.media-amazon.com/images/I/712Uqa2XjhL._AC_._US550_SCLZZZZZZZ_.jpg",
      "url": "https://www.amazon.com/shop/sydneydelrey/list/35KWG9X334D4Q?tag=sydneybertonc-20"
    },
    {
      "title": "my amazon boot collection",
      "itemCount": 59,
      "image": "https://m.media-amazon.com/images/I/71noBGE95aL._AC_._US550_SCLZZZZZZZ_.jpg",
      "url": "https://www.amazon.com/shop/sydneydelrey/list/3C0MB7YWND2K7?tag=sydneybertonc-20"
    }
  ],
  "videos": [],
  "trendingPicks": [
    {
      "url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0HFW6KYLX?showRelatedPost=true&tag_override=sydneybertonc-20",
      "image": "https://m.media-amazon.com/images/I/41mAxS-NXqL._AC_.jpg",
      "price": 28.49,
      "discount": null
    },
    {
      "url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FP2BWB5V?showRelatedPost=true&tag_override=sydneybertonc-20",
      "image": "https://m.media-amazon.com/images/I/31NrjtxUVvL._AC_.jpg",
      "price": 58.49,
      "discount": null
    }
  ],
  "curations": [
    {
      "title": "SHOES ✨",
      "postCount": 14,
      "image": "https://m.media-amazon.com/images/I/31eFzhWptZL._US225_SCLZZZZZZZ_.jpg",
      "url": "https://www.amazon.com/shop/sydneydelrey/curation/bdca11e0-6920-4402-ac72-2f2016ed1e36"
    },
    {
      "title": "f/w fit try ons",
      "postCount": 109,
      "image": "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",
      "url": "https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae"
    }
  ],
  "pageToken": "v2_WzAsMTc5MjQyMjAyMDA4MCwiYW16bjEuaWRlYXMuMzE2OU4zRTJKNjI1VCJd"
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The first page has the profile (`name`, `avatar`, `description`, `socials`, `isTopCreator`) plus `lists`, `videos`, `trendingPicks` and `curations`. Later pages, requested with the same `url` and the previous `pageToken`, carry only `lists` and `videos`. `pageToken` is null after the last page; a page past the end returns empty lists for 0 credits. `discount` in trending picks is always null. An unknown shop is a free 404; a URL that is not an Amazon shop, or a `pageToken` that does not belong to the shop, is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.