/v1/amazon/shop
Amazon Shop page
Get products and other details from a creator's Amazon Shop page
| Credit cost | Default: 1 credit How charges are determinedCost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute. |
|---|---|
| Cache support | Not specified in the published contract. |
| Pagination | No explicit pagination metadata in the published contract. Consult the parameters and response fields below. |
Parameters
| Name | Location / required | Schema |
|---|---|---|
urlURL to Amazon Shop page | query / required |
|
pageTokenOpaque page token returned by a previous response for the same shop URL. Pass it back unchanged and do not infer the response type from its prefix. A page can contain lists, videos, or both. | query / optional |
|
Request examples
Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.
cURL
curl --request GET 'https://api.fetchproof.com/v1/amazon/shop?url=YOUR_URL' \
--header 'x-api-key: YOUR_API_KEY'JavaScript
const response = await fetch("https://api.fetchproof.com/v1/amazon/shop?url=YOUR_URL", {
method: 'GET',
headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());Python
import os
import requests
response = requests.get("https://api.fetchproof.com/v1/amazon/shop?url=YOUR_URL",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)Responses
200Success. Envelope: success / credits_remaining / credits_charged.
application/json
object
successrequired
boolean
credits_remainingrequired
integer
credits_chargedrequired
integer
avatarrequired
string
namerequired
string
descriptionrequired
string
socialsrequired
array
Array items
string
listsrequired
array
Array items
object
titlerequired
string
itemCountrequired
integer
imagerequired
string
urlrequired
string
videosrequired
array
Array items
object
idrequired
string
titlerequired
string
thumbnailrequired
string
asinsrequired
array
Array items
string
trendingPicksrequired
array
Array items
object
urlrequired
string
imagerequired
string
pricerequired
number
discountrequired
integer
curationsrequired
array
Array items
object
titlerequired
string
postCountrequired
integer
imagerequired
string
urlrequired
string
pageTokenrequired
string