# Amazon API guide



## Start with Amazon



Find products, inspect a listing and read its available reviews or seller offers. Keep the marketplace consistent throughout a comparison.



These requests use your API key and can spend credits. Check the current price on the endpoint page; each new page is a separate request. Later examples use illustrative identifiers: replace them with values from your earlier response.



### 1. Find a product



Take the chosen product’s ASIN from the search results. Do not match products only by title. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/amazon/search)



**amazon/search**

```
curl "https://www.monocrawl.com/v1/amazon/search?query=standing%20desk&country=GB" \
  -H "x-api-key: mn_your_key_here"
```



### 2. Read the listing



Replace the example ASIN with your selected result and keep the same country. Check price, currency, variant and availability together. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/amazon/product)



**amazon/product**

```
curl "https://www.monocrawl.com/v1/amazon/product?asin=B0CHX3QBCH&country=GB" \
  -H "x-api-key: mn_your_key_here"
```



### 3. Read customer feedback



Use the same ASIN and marketplace. The returned reviews are a source-defined sample, not a promise of all reviews. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/amazon/reviews)



**amazon/reviews**

```
curl "https://www.monocrawl.com/v1/amazon/reviews?asin=B0CHX3QBCH&country=GB" \
  -H "x-api-key: mn_your_key_here"
```



## Choose filters with the source behavior in mind



| Control | Behavior and limits |
| --- | --- |
| Marketplace precedence | country wins over location; otherwise an Amazon input URL can select its marketplace. With no selector the default is GB. Keep the resolved marketplace on every search, product, reviews and sellers call; an ASIN alone does not select the US store. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/amazon/product) |
| Search controls | query, department, language and marketplace control discovery; limit is at most 100. Search results are not guaranteed to have all product-detail fields. Open the chosen ASIN before depending on variants, availability or seller information. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/amazon/search) |
| Review depth | sort accepts helpful or recent; limit is at most 100. This route has no public cursor parameter: do not invent a page number or assume that the sample covers every review. Dates can be source text rather than ISO timestamps. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/amazon/reviews) |
| Comparable prices | Compare price together with currency, condition, delivery text and seller. A listing amount is not a checkout quote and does not guarantee tax, delivery charges, stock or variant availability. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/amazon/sellers) |
| Ratings | rating is an object with value, votes and max when available. A product’s aggregate rating and an individual review’s star rating describe different populations; preserve both the scale and sample size. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/amazon/product) |



Source availability, ordering and field coverage can change. Inspect warnings and partial-result metadata alongside the rows. See [runnable workflows](https://www.monocrawl.com/docs/workflows), [metric semantics](https://www.monocrawl.com/docs/metric-semantics), [computed fields](https://www.monocrawl.com/docs/computed-fields) and the [pagination matrix](https://www.monocrawl.com/docs/pagination).



## Match the operation to your task



| Your task | Endpoint | When to use it |
| --- | --- | --- |
| Compare offers for one product | [`sellers`](https://www.monocrawl.com/docs/endpoints/amazon/sellers) | Keep condition, delivery and seller details alongside price. |
| Inspect a seller | [`seller`](https://www.monocrawl.com/docs/endpoints/amazon/seller) | A seller record has a different identifier from a product ASIN. |
| Explore a category | [`best-sellers`](https://www.monocrawl.com/docs/endpoints/amazon/best-sellers) | Check the endpoint’s category and marketplace parameters. |
| Find promotions | [`deals`](https://www.monocrawl.com/docs/endpoints/amazon/deals) | An observed offer is not a checkout-price guarantee. |



Explore all documented operations by purpose below. Each endpoint reference contains its accepted parameters and current price.



### Reviews and offers



- [`best-sellers`](https://www.monocrawl.com/docs/endpoints/amazon/best-sellers)

- [`deals`](https://www.monocrawl.com/docs/endpoints/amazon/deals)

- [`reviews`](https://www.monocrawl.com/docs/endpoints/amazon/reviews)

- [`seller`](https://www.monocrawl.com/docs/endpoints/amazon/seller)

- [`seller-products`](https://www.monocrawl.com/docs/endpoints/amazon/seller-products)

- [`seller-reviews`](https://www.monocrawl.com/docs/endpoints/amazon/seller-reviews)

- [`sellers`](https://www.monocrawl.com/docs/endpoints/amazon/sellers)



### Products and categories



- [`categories`](https://www.monocrawl.com/docs/endpoints/amazon/categories)

- [`product`](https://www.monocrawl.com/docs/endpoints/amazon/product)

- [`shop`](https://www.monocrawl.com/docs/endpoints/amazon/shop)



### Search and discovery



- [`search`](https://www.monocrawl.com/docs/endpoints/amazon/search)



## Endpoint reference

## amazon/best-sellers

`GET /v1/amazon/best-sellers`

A marketplace best-seller chart: rank, product, price, rating and rank movement.

*Amazon best sellers*

| Parameter | Required | Description |
| --- | --- | --- |
| `category` | yes | Best-sellers category or subcategory path — e.g. `software` |
| `country` | no | Marketplace country code (default GB) — e.g. `US` |
| `type` | no | BEST_SELLERS, NEW_RELEASES, MOVERS_AND_SHAKERS, MOST_WISHED_FOR or GIFT_IDEAS Accepted values: BEST_SELLERS, NEW_RELEASES, MOVERS_AND_SHAKERS, MOST_WISHED_FOR, GIFT_IDEAS. Case, spaces, hyphens and underscores are interchangeable. — e.g. `BEST_SELLERS` |
| `page` | no | Page of 50 — e.g. `1` |
| `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/best-sellers?category=software" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "category": "example",
  "checked_at": "2026-09-01T12:00:00Z",
  "count": 0,
  "country": "example",
  "cursor": null,
  "domain": "example",
  "has_more": false,
  "items": [
    {
      "asin": "example",
      "image": "https://example.com/example",
      "platform": "example",
      "price": 0,
      "rank": 0,
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "reviews_count": 0,
      "title": "example",
      "url": "https://example.com/example"
    }
  ],
  "marketplace": {
    "country": "example",
    "domain": "example"
  },
  "page": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/best-sellers#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/best-sellers.json)


## amazon/categories

`GET /v1/amazon/categories`

The marketplace's departments with the ids the product search takes.

*Amazon departments*

| Parameter | Required | Description |
| --- | --- | --- |
| `country` | no | Marketplace country code (default GB) — e.g. `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/categories" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "country": "example",
  "has_more": false,
  "items": [
    {
      "id": "example",
      "name": "example"
    }
  ],
  "marketplace": {
    "country": "example",
    "domain": "example"
  }
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/categories#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/categories.json)


## amazon/deals

`GET /v1/amazon/deals`

The marketplace deals feed with deal and list price, savings, badge, state and timing.

*Amazon deals*

| Parameter | Required | Description |
| --- | --- | --- |
| `country` | no | Marketplace country code (default GB) — e.g. `US` |
| `categories` | no | Departments, comma-separated — e.g. `electronics` |
| `brands` | no | Brands, comma-separated — e.g. `Anker` |
| `cursor` | no | Offset from the previous page — e.g. `30` |
| `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/deals" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "checked_at": "2026-09-01T12:00:00Z",
  "count": 0,
  "country": "example",
  "cursor": null,
  "domain": "example",
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "asin": "example",
      "badge": "example",
      "canonical_url": "https://example.com/example",
      "currency": "example",
      "ends_at": "2026-09-01T12:00:00Z",
      "id": "example",
      "image": "https://example.com/example",
      "list_price": 0,
      "platform": "example",
      "price": 0,
      "savings_amount": 0,
      "savings_percentage": 0,
      "state": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "marketplace": {
    "country": "example",
    "domain": "example"
  }
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/deals#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/deals.json)


## amazon/product

`GET /v1/amazon/product`

One Amazon product by ASIN: title, description, images, price, rating, brand, categories and availability. Queued task.

*Amazon product*

| Parameter | Required | Description |
| --- | --- | --- |
| `asin` | yes | ASIN, or an Amazon product URL — e.g. `B0CHX3QBCH` |
| `location` | no | Location name (sets the marketplace) — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/product?asin=B0CHX3QBCH" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "asin": "DEMO000001",
  "title": "Example desk lamp",
  "brand": "Example Goods",
  "price": 42,
  "currency": "GBP",
  "reviews_count": 84,
  "availability": "In stock"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/product#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/product.json)


## amazon/reviews

`GET /v1/amazon/reviews`

Available reviews of an Amazon product with rating, text, date, verification and helpful votes. Results may contain only the product page's top reviews; the full review history is not guaranteed.

*Amazon reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `asin` | yes | ASIN, or an Amazon product URL — e.g. `B0CHX3QBCH` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `sort` | no | helpful or recent Accepted values: helpful, recent. Case, spaces, hyphens and underscores are interchangeable. — e.g. `recent` |
| `limit` | no | Requested maximum reviews (1 to 100). Availability may be limited to the product page's top reviews; this does not guarantee the requested quantity. — e.g. `20` |
| `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/reviews?asin=B0CHX3QBCH" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "id": "example_review",
      "title": "A useful lamp",
      "text": "An illustrative review.",
      "rating": {
        "value": 4,
        "votes": null,
        "max": 5
      },
      "posted_at": null,
      "verified": true,
      "variant": "Colour: Black"
    }
  ],
  "cursor": null,
  "has_more": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/reviews.json)


## amazon/search

`GET /v1/amazon/search`

Products for a query on Amazon with price range, rating, review count, badges and delivery. Queued task.

*Amazon product search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search terms — e.g. `standing desk` |
| `location` | no | Location name (sets the marketplace) — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `department` | no | Amazon department — e.g. `Electronics` |
| `limit` | no | Requested rows per response, 1–1000. The source may return fewer. Remaining rows from an already purchased page use a saved cursor and cost zero to retrieve for up to one hour; further native source pages use this endpoint’s normal price. — e.g. `5` |
| `cursor` | no | Use the returned cursor unchanged, retaining the original query, filters and limit. Saved mlo1. cursors retrieve already purchased rows at zero credits for up to one hour. A native source cursor, when supplied, starts a normally priced source page. Quote with dry_run before continuing. |
| `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/search?query=standing%20desk" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "asin": "DEMO000001",
      "title": "Example desk lamp",
      "price": 42,
      "currency": "GBP",
      "rating": {
        "value": 4.5,
        "votes": 84,
        "max": 5
      },
      "reviews_count": 84
    }
  ],
  "cursor": null,
  "has_more": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/search.json)


## amazon/seller

`GET /v1/amazon/seller`

A marketplace seller's public profile with rating, positive percentage and feedback summary. Contact details are never included.

*Amazon seller profile*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Seller id (from a product's seller or offers) — e.g. `AY7AQ12Q1GTNE` |
| `country` | no | Marketplace country code (default GB) — e.g. `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/seller?id=AY7AQ12Q1GTNE" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "country": "example",
  "id": "example",
  "marketplace": {
    "country": "example",
    "domain": "example"
  },
  "platform": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/seller#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/seller.json)


## amazon/seller-products

`GET /v1/amazon/seller-products`

The products a marketplace seller lists, with price, rating and badges.

*Amazon seller listings*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Seller id — e.g. `AY7AQ12Q1GTNE` |
| `country` | no | Marketplace country code (default GB) — e.g. `US` |
| `page` | no | Page — e.g. `1` |
| `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/seller-products?id=AY7AQ12Q1GTNE" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_meta": {
    "billing": {
      "charged": 0,
      "list_price": 0,
      "reason": "example"
    }
  },
  "count": 0,
  "has_more": false,
  "items": [],
  "marketplace": {
    "country": "example",
    "domain": "example"
  },
  "page": 0,
  "seller_id": "example",
  "total_results": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/seller-products#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/seller-products.json)


## amazon/seller-reviews

`GET /v1/amazon/seller-reviews`

Feedback left for a marketplace seller with rating, text, date and whether the seller responded.

*Amazon seller feedback*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Seller id — e.g. `AY7AQ12Q1GTNE` |
| `country` | no | Marketplace country code (default GB) — e.g. `US` |
| `page` | no | Page number (default 1). Use page or the returned cursor, not both. — e.g. `1` |
| `cursor` | no | When returned, pass this cursor unchanged to continue with the same supplier. Keep the same seller id and country and omit page. Each fetched page costs the normal five credits. A cursor from an unavailable source cannot be moved to another supplier. |
| `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/seller-reviews?id=AY7AQ12Q1GTNE" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [],
  "cursor": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/seller-reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/seller-reviews.json)


## amazon/sellers

`GET /v1/amazon/sellers`

Every seller offering an Amazon product with price, condition, shipping and seller rating. Queued task.

*Amazon sellers*

| Parameter | Required | Description |
| --- | --- | --- |
| `asin` | yes | ASIN, or an Amazon product URL — e.g. `B0CHX3QBCH` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/amazon/sellers?asin=B0CHX3QBCH" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "seller": "Example Store",
      "price": 42,
      "currency": "GBP",
      "condition": "New",
      "shipping": null
    }
  ],
  "cursor": null,
  "has_more": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/sellers#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/sellers.json)


## amazon/shop

`GET /v1/amazon/shop`

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.

*Amazon shop page*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | An Amazon shop (influencer storefront) page URL, or the shop name — e.g. `https://www.amazon.com/shop/tastemade` |
| `country` | no | Amazon marketplace — e.g. `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. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 14 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
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"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "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"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/amazon/shop#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/amazon/shop.json)