> ## 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.

# Shopee Products

> Get Shopee product listings from keyword, category, or URL, with price, discount, seller, ratings, stock & shipping

`$4.5 / 1k products`

Get Shopee product listings from keyword, category, or URL, with price, discount, seller, ratings, stock & shipping

## Endpoint

`POST /api/v1/agents/shopee/products/run`

## Parameters

<ParamField body="inputs" type="array" required>
  **List** · One per line. You can input search keywords, Shopee shop URLs, or category URLs (e.g. shopee.com.br/Tenis-cat.11013548).
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Total products across all inputs. Use 0 for all.
</ParamField>

<ParamField body="country" type="string" default="BR">
  **Dropdown** · Shopee marketplace to scrape (auto-detected from URLs when present).

  <Accordion title="Show all 8 options">
    `BR`, `SG`, `MY`, `TH`, `VN`, `PH`, `ID`, `MX`

    *Legend: `BR` = Brazil, `SG` = Singapore, `MY` = Malaysia, `TH` = Thailand, `VN` = Vietnam, `PH` = Philippines, `ID` = Indonesia, `MX` = Mexico*

    [View all 8 as a structured list →](/agents/shopee/products/values#country)
  </Accordion>
</ParamField>

<ParamField body="priceSlicing" type="boolean" default={false}>
  **Toggle** · ⚠ Runs each input 6× across price buckets to bypass Shopee's per-search dedup cap. \~6× the cost — only enable if you need maximum coverage.
</ParamField>

## Response columns

| Field         | Display name | Type     |
| ------------- | ------------ | -------- |
| `productUrl`  | Product URL  | url      |
| `productName` | Product Name | text     |
| `price`       | Price        | currency |
| `priceMax`    | Price Max    | currency |
| `currency`    | Currency     | text     |
| `rating`      | Rating       | rating   |
| `ratingCount` | Rating Count | number   |
| `reviewCount` | Review Count | number   |
| `favorites`   | Favorites    | number   |
| `shop`        | Shop         | text     |
| `location`    | Location     | text     |
| `brand`       | Brand        | text     |
| `imageUrls`   | Image URLs   | text     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/shopee/products/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "location": "iPhone 15",
      "maxResults": 10
    }
  }'
  ```

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

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/shopee/products/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "location": "iPhone 15",
      "maxResults": 10
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "productUrl": "https://shopee.com.br/-i.250218329.21699845272",
      "productName": "iPhone 15 128GB \u2022 Lacrado \u2022 Novo \u2022 Original \u2022 Garantia",
      "price": 4398,
      "priceMax": 4444,
      "currency": "BRL",
      "rating": 4.98,
      "ratingCount": 633,
      "reviewCount": 633,
      "favorites": 10139,
      "shop": "Future Tech_",
      "location": "Paran\u00e1",
      "brand": "Apple",
      "imageUrls": [
        "https://cf.shopee.com.br/file/br-11134207-7r98o-mcwfas3aq2v5d3",
        "https://cf.shopee.com.br/file/br-11134207-7r98o-mcwfas3avp4x2b",
        "https://cf.shopee.com.br/file/br-11134207-7r98o-mcwfas3asw019a",
        "https://cf.shopee.com.br/file/br-11134207-7r98o-mcwhn7c4x79de9",
        "https://cf.shopee.com.br/file/br-11134207-7r98o-mcwfas3auakh44"
      ]
    }
  ]
}
```