> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon Bestsellers

> Get Amazon bestseller products from category URLs, with rankings, ratings, and prices

`$2.7 / 1k products`

Get Amazon bestseller products from category URLs, with rankings, ratings, and prices

## Endpoint

`POST /api/v1/agents/amazon/bestsellers/run`

## Parameters

<ParamField body="urls" type="array" required>
  **List** · List of Amazon bestseller category URLs (must contain /zgbs/ or /bestsellers/). One per line.
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Products per category. Use 0 for all.
</ParamField>

## Response columns

| Field            | Display name    | Type     |
| ---------------- | --------------- | -------- |
| `bestsellerUrl`  | Bestseller URL  | url      |
| `productUrl`     | Product URL     | url      |
| `title`          | Title           | text     |
| `image`          | Image           | url      |
| `rank`           | Rank            | number   |
| `price`          | Price           | currency |
| `currency`       | Currency        | text     |
| `rating`         | Rating          | rating   |
| `reviews`        | Reviews         | number   |
| `category`       | Category        | text     |
| `categoryFull`   | Category Full   | text     |
| `categoryUrl`    | Category URL    | url      |
| `subcategory`    | Subcategory     | text     |
| `subcategoryUrl` | Subcategory URL | url      |
| `asin`           | ASIN            | text     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/amazon/bestsellers/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "urls": [
        "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/"
      ],
      "maxResults": 100,
      "depthOfCrawl": 1
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/amazon/bestsellers/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "urls": [
          "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/"
      ],
      "maxResults": 100,
      "depthOfCrawl": 1
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "bestsellerUrl": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/",
      "productUrl": "https://www.amazon.com/dp/B08JHCVHTY",
      "title": "blink plus plan with monthly auto-renewal",
      "image": "https://images-na.ssl-images-amazon.com/images/I/31YHGbJsldL._AC_UL300_SR300,200_.png",
      "rank": 1,
      "price": 11.99,
      "currency": "$",
      "rating": 4.4,
      "reviews": 275148,
      "category": "Electronics",
      "categoryFull": "Best Sellers in Electronics",
      "categoryUrl": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/",
      "subcategory": null,
      "subcategoryUrl": null,
      "asin": "B08JHCVHTY"
    }
  ]
}
```