API reference

Amazon Shop Page API

An Amazon shop page: the storefront profile, its posts (idea lists, photos, videos) and the products of its first idea list with prices and ratings.

Read as Markdown Use with an AI agent

Endpoint

GET/v1/amazon/shoplive · proven14 credits

Try in Playground

Parameters

Query parameters

Name	Required	Description	Example
`url`	yes	An Amazon shop (influencer storefront) page URL, or the shop name	`https://www.amazon.com/shop/tastemade`
`country`	no	Amazon marketplace	`US`
`dry_run`	no	Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution.	`1`

Examples

Make the request

curl

curl "https://www.monocrawl.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Ftastemade" \
  -H "x-api-key: mn_your_key_here"

TypeScript

typescript

const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
  "https://www.monocrawl.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Ftastemade",
  { headers: { "x-api-key": key } },
);
const body = await res.json();

if (!body.success) {
  // one error shape for every endpoint — see /docs/errors
  throw new Error(`${body.error.type}: ${body.error.message}`);
}

console.log(body.data, "credits left:", body.credits_remaining);

Python

python

import os
import requests

res = requests.get(
    "https://www.monocrawl.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Ftastemade",
    headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
    timeout=60,
)
body = res.json()

if not body["success"]:
    # one error shape for every endpoint — see /docs/errors
    raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")

print(body["data"], "credits left:", body["credits_remaining"])

Response

Response fields and example

This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.

200 · application/json

{
  "success": true,
  "platform": "amazon",
  "endpoint": "/v1/amazon/shop",
  "data": {
    "affiliate_status": "example",
    "count": 0,
    "country": "example",
    "description": "example",
    "handle": "example",
    "is_top_creator": false,
    "items": [
      {
        "asin": "example",
        "climate_pledge_friendly": false,
        "is_amazon_choice": false,
        "is_best_seller": false,
        "platform": "example",
        "price": 0,
        "rank": 0,
        "title": "example",
        "type": "example",
        "url": "https://example.com/example"
      }
    ],
    "marketplace": {
      "country": "example",
      "domain": "example"
    },
    "name": "example",
    "platform": "example",
    "posts": [
      {
        "id": "example",
        "items_count": 0,
        "pinned": false,
        "thumbnail": "example",
        "title": "example",
        "type": "example",
        "url": "https://example.com/example"
      }
    ],
    "posts_count": 0,
    "posts_cursor": "example",
    "products": [
      {
        "asin": "example",
        "climate_pledge_friendly": false,
        "is_amazon_choice": false,
        "is_best_seller": false,
        "platform": "example",
        "price": 0,
        "rank": 0,
        "title": "example",
        "type": "example",
        "url": "https://example.com/example"
      }
    ],
    "products_of_post": "example",
    "url": "https://example.com/example"
  },
  "credits_used": 14,
  "credits_remaining": 99,
  "request_id": "req_…",
  "cached": false
}

The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.

Schema basis: observed response shapes, not an exhaustive field specification. See schema coverage and validation limits.

Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.

Field inside data	Type	Meaning
`affiliate_status`	`string \| null`	Optional affiliate status supplied by this operation. Null means unknown.
`count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`country`	`string \| null`	Optional country supplied by this operation. Null means unknown.
`description`	`string \| null`	Source description; null or absent means not supplied.
`handle`	`string \| null`	Optional handle supplied by this operation. Null means unknown.
`is_top_creator`	`boolean \| null`	Optional is top creator supplied by this operation. Null means unknown.
`items`	`array \| null`	Returned records. Source coverage and completeness vary.
`items[].asin`	`string \| null`	Optional asin supplied by this operation. Null means unknown.
`items[].climate_pledge_friendly`	`boolean \| null`	Optional climate pledge friendly supplied by this operation. Null means unknown.
`items[].is_amazon_choice`	`boolean \| null`	Optional is amazon choice supplied by this operation. Null means unknown.
`items[].is_best_seller`	`boolean \| null`	Optional is best seller supplied by this operation. Null means unknown.
`items[].platform`	`string \| null`	Optional platform supplied by this operation. Null means unknown.
`items[].price`	`number \| null`	Source price. Currency, taxes and availability depend on the listing.
`items[].rank`	`number \| null`	Optional rank supplied by this operation. Null means unknown.
`items[].title`	`string \| null`	Source title when supplied.
`items[].type`	`string \| null`	Optional type supplied by this operation. Null means unknown.
`items[].url`	`string \| null`	Original source URL when supplied.
`marketplace`	`object \| null`	Optional marketplace supplied by this operation. Null means unknown.
`marketplace.country`	`string \| null`	Optional country supplied by this operation. Null means unknown.
`marketplace.domain`	`string \| null`	Optional domain supplied by this operation. Null means unknown.
`name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`platform`	`string \| null`	Optional platform supplied by this operation. Null means unknown.
`posts`	`array \| null`	Optional posts supplied by this operation. Null means unknown.
`posts[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`posts[].items_count`	`number \| null`	Optional items count supplied by this operation. Null means unknown.
`posts[].pinned`	`boolean \| null`	Optional pinned supplied by this operation. Null means unknown.
`posts[].thumbnail`	`string \| null`	Optional thumbnail supplied by this operation. Null means unknown.
`posts[].title`	`string \| null`	Source title when supplied.
`posts[].type`	`string \| null`	Optional type supplied by this operation. Null means unknown.
`posts[].url`	`string \| null`	Original source URL when supplied.
`posts_count`	`number \| null`	Optional posts count supplied by this operation. Null means unknown.
`posts_cursor`	`string \| null`	Optional posts cursor supplied by this operation. Null means unknown.
`products`	`array \| null`	Optional products supplied by this operation. Null means unknown.
`products[].asin`	`string \| null`	Optional asin supplied by this operation. Null means unknown.
`products[].climate_pledge_friendly`	`boolean \| null`	Optional climate pledge friendly supplied by this operation. Null means unknown.
`products[].is_amazon_choice`	`boolean \| null`	Optional is amazon choice supplied by this operation. Null means unknown.
`products[].is_best_seller`	`boolean \| null`	Optional is best seller supplied by this operation. Null means unknown.
`products[].platform`	`string \| null`	Optional platform supplied by this operation. Null means unknown.
`products[].price`	`number \| null`	Source price. Currency, taxes and availability depend on the listing.
`products[].rank`	`number \| null`	Optional rank supplied by this operation. Null means unknown.
`products[].title`	`string \| null`	Source title when supplied.
`products[].type`	`string \| null`	Optional type supplied by this operation. Null means unknown.
`products[].url`	`string \| null`	Original source URL when supplied.
`products_of_post`	`string \| null`	Optional products of post supplied by this operation. Null means unknown.
`url`	`string \| null`	Original source URL when supplied.

Optional fields reviewed from preserved successful responses. Additive fields and source variations remain allowed; validate the fields your workflow requires.

The example is invented and illustrates types only; zero and empty values are not claims about a real result.

Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference

Amazon Shop Page API

Query parameters

Make the request

Response fields and example

More Amazon reference

First call in under a minute