shopee.com.br
Shopee API
Query public Shopee data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Extracts search/listing results (PLP) from Shopee Brazil with rendered processing and structured return in JSON. Cost: 5 credits per request.
GeckoAPI is independent of Shopee. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search products
shopee.com.br:plp
Extracts search/listing results (PLP) from Shopee Brazil with rendered processing and structured return in JSON. Cost: 5 credits per request.
5 credits per request
Get product details
shopee.com.br:pdp
Extracts rich product data (PDP) from Shopee Brazil from the page's raw HTML, including seller, variations, media, shipping, stock and attributes. Cost: 5 credits per request.
5 credits per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Coverage and limitations
Search takes keyword or a /search URL; page is not supported. Use each result URL for product details. This endpoint covers Brazil with BRL prices. Requests can take up to one minute: allow 90 seconds in your client. These are public product data, not seller account operations or affiliate commissions.
Some requests can take up to 1 minute to respond. This is expected for this operation; wait for the request to complete.
Make your first request
The example uses search products. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "notebook gamer",
"target": "shopee.com.br",
"type": "plp"
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"requestId": "f38d98f0-8d1b-42a7-9a15-8f75d20ac1e7",
"executionId": "5afac754-6361-4f84-8a78-80b8dc6ce6dd",
"data": {
"source": "shopee.com.br",
"type": "plp",
"url": "https://shopee.com.br/search?keyword=notebook%20gamer",
"requestUrl": "https://shopee.com.br/search?keyword=notebook%20gamer",
"extractedAt": "2026-04-18T15:20:30.000Z",
"query": "notebook gamer",
"totalResults": 6167,
"primaryResults": 1,
"page": 1,
"resultsPerPage": 60,
"offset": 0,
"nextPage": 2,
"items": [
{
"url": "https://shopee.com.br/product/387363734/58254322220",
"itemId": "58254322220",
"shopId": "387363734",
"sku": "58254322220",
"name": "Notebook Dell 3410 Core I5 10g 8gb 240ssd Detalhe Na Carcaça Cinza (Usado)",
"currency": "BRL",
"currencyRaw": "R$",
"price": 1784.15,
"priceMin": 1784.15,
"priceMax": 1784.15,
"regularPrice": 2099,
"regularPriceMin": 2099,
"regularPriceMax": 2099,
"discountPercentage": 15,
"soldCount": 254,
"likedCount": 31,
"stock": 12,
"brand": "Dell"
}
]
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the Shopee API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.