Skip to main content
GET
/
shopee
/
search
Shopee Search
curl --request GET \
  --url https://api.example.com/shopee/search

​
Overview

The /shopee/search endpoint searches Shopee Indonesia (shopee.co.id) and returns structured product data including pricing, ratings, seller information, and shipping details.
This endpoint uses browser rendering to bypass anti-bot protection. Requests may take longer compared to renderless endpoints.
Currently only Indonesia (country=id) is supported. More Southeast Asian markets will be added in future updates.

​
Credits

25 credits per successful request.

​
Parameters

​
Query Parameters

​
q
string
required
The product search query
​
country
string
required
Country code. Currently only id (Indonesia) is supported.
​
page
number
default:"0"
Page number for pagination (0-indexed, starts at 0)
​
sortBy
string
Sort order for results:
  • relevance - Most relevant (default)
  • ctime - Latest/newest first
  • sales - Best selling
  • price - Price: Low to High
  • -price - Price: High to Low
​
priceMin
number
Minimum price filter (in IDR)
​
priceMax
number
Maximum price filter (in IDR)
​
rating
number
Minimum rating filter (1-5)
​
freeShipping
boolean
default:"false"
Filter for products with free shipping (Gratis Ongkir)

​
Example Requests

curl -X GET "https://api.scrapengine.io/api/v1/shopee/search?q=laptop&country=id" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Search with Filters

curl -X GET "https://api.scrapengine.io/api/v1/shopee/search?q=headphones&country=id&priceMin=100000&priceMax=500000&freeShipping=true&sortBy=sales" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Search with Rating Filter

curl -X GET "https://api.scrapengine.io/api/v1/shopee/search?q=smartphone&country=id&rating=4&sortBy=-price" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
Success Response (200)

Returns parsed product search results: 
{
  "query": "laptop",
  "totalResults": 15420,
  "products": [
    {
      "position": 1,
      "itemId": "12345678901",
      "shopId": "987654321",
      "name": "Laptop Gaming ASUS ROG Strix G15 RTX 4060",
      "link": "https://shopee.co.id/Laptop-Gaming-ASUS-ROG-Strix-G15-i.987654321.12345678901",
      "image": "https://down-id.img.susercontent.com/file/abc123.jpg",
      "price": 15999000,
      "priceDisplay": "Rp15.999.000",
      "originalPrice": 18999000,
      "discount": "-16%",
      "currency": "Rp",
      "rating": 4.9,
      "ratingCount": 2341,
      "soldCount": 5230,
      "soldCountDisplay": "5,2rb terjual",
      "location": "Jakarta Pusat",
      "shopName": "ASUS Official Store",
      "isOfficialShop": true,
      "isPreferredSeller": false,
      "isSponsored": false,
      "isFreeShipping": true
    }
  ],
  "pagination": {
    "currentPage": 0,
    "totalPages": 386,
    "nextPageUrl": "https://shopee.co.id/search?keyword=laptop&page=1"
  },
  "searchUrl": "https://shopee.co.id/search?keyword=laptop",
  "country": "id"
}

​
Response Headers

HeaderDescription
x-remaining-creditsNumber of API credits remaining
x-trace-idUnique identifier for the request

​
Error Responses

StatusDescription
400Bad Request - Invalid query parameters or unsupported country
401Unauthorized - Invalid or missing API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Use Cases

  • Indonesian e-commerce research: Analyze product trends on Shopee Indonesia
  • Price monitoring: Track product prices for competitive analysis
  • Seller analysis: Identify official shops and Star/Preferred sellers
  • Shipping optimization: Find products with free shipping (Gratis Ongkir)
  • Product discovery: Find best-selling products by category
  • Market intelligence: Monitor pricing trends in the Indonesian market

​
Notes

  • This endpoint requires browser rendering which may result in longer response times
  • Shopee uses 0-indexed pagination (page 0 is the first page)
  • Prices are in Indonesian Rupiah (IDR)
  • The soldCountDisplay field shows the Indonesian format (e.g., “5,2rb terjual” = 5,200 sold)
  • Official shops are verified brand stores on Shopee Mall
  • Preferred/Star sellers have high ratings and good service records