Creator Mağazası

GET/v1/amazon/shop1 kredi

Bir Amazon influencer mağazasını döndürür: içerik üreticisinin profili ve sosyal medya bağlantıları, fikir listeleri, alışveriş videoları, trend ürünleri ve seçkileri; kalan liste ve videolar sayfalanarak alınabilir.

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Mağaza URL'si, örneğin `https://www.amazon.com/shop/sydneydelrey`.
pageTokenisteğe bağlı	string	Aynı mağaza için bir önceki yanıttaki `pageToken` değeri; sonraki sayfayı getirir.

02İstek

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

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

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"
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

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

04Notlar

İlk sayfa profili (`name`, `avatar`, `description`, `socials`, `isTopCreator`) ve `lists`, `videos`, `trendingPicks`, `curations` alanlarını içerir. Aynı `url` ve bir önceki `pageToken` ile istenen sonraki sayfalarda yalnızca `lists` ve `videos` bulunur. Son sayfadan sonra `pageToken` null olur; son sayfanın ötesi boş listelerle döner ve 0 kredi tutar. Trend ürünlerindeki `discount` alanı her zaman null'dır. Bilinmeyen bir mağaza ücretsiz 404 döner; Amazon mağazası olmayan bir URL veya mağazaya ait olmayan bir `pageToken` ücretsiz 400 döner.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.