Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$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

​
inputs
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).
​
maxResults
integer
default:100
Number · Total products across all inputs. Use 0 for all.
​
country
string
default:"BR"
Dropdown · Shopee marketplace to scrape (auto-detected from URLs when present).
BR, SG, MY, TH, VN, PH, ID, MXLegend: BR = Brazil, SG = Singapore, MY = Malaysia, TH = Thailand, VN = Vietnam, PH = Philippines, ID = Indonesia, MX = MexicoView all 8 as a structured list →
​
priceSlicing
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.

​
Response columns

FieldDisplay nameType
productUrlProduct URLurl
productNameProduct Nametext
pricePricecurrency
priceMaxPrice Maxcurrency
currencyCurrencytext
ratingRatingrating
ratingCountRating Countnumber
reviewCountReview Countnumber
favoritesFavoritesnumber
shopShoptext
locationLocationtext
brandBrandtext
imageUrlsImage URLstext

​
Example

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
  }
}'

​
Example response

Response
{
  "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"
      ]
    }
  ]
}