身份验证与访问权限
获取 API 访问权限
API 访问需要符合条件的 Ecomblade 方案。创建密钥，在显示时保存 secret，并以 Bearer token 发送。
GET
/api/v1/products/search商品搜索 · platform, query, country, page=1, filters?GET
/api/v1/products/category类目商品 · platform, categoryId, country, categoryLevel=2, page=1请求示例
curl --get 'https://api.ecomblade.com/api/v1/products/search?platform=shopee&query=wireless+earbuds&page=1&country=MY' \
--header 'Authorization: Bearer $ECOMBLADE_API_KEY'API 返回的数据
响应示例
响应包含标准化商品字段和平台专属数据，例如商品标识、URL、图片、价格、货币、评分、销量、营收及可用的店铺信息。
JSON
{
"success": true,
"data": {
"status": 200,
"items": [
{
"itemId": "10001234567",
"name": "Wireless Noise-Cancelling Earbuds",
"slug": "wireless-noise-cancelling-earbuds-i.500123456.10001234567",
"url": "https://shopee.com.my/wireless-noise-cancelling-earbuds-i.500123456.10001234567",
"brand": "Example Audio",
"image": "https://cf.example.com/file/example-earbuds",
"shopId": "500123456",
"shopName": "Example Audio Official",
"price": 129.9,
"originalPrice": 169.9,
"discount": 24,
"currency": "MYR",
"sold": 1280,
"monthlySold": 340,
"totalSold": 4620,
"revenue": 166272,
"monthlyRevenue": 44166,
"totalRevenue": 600138,
"listingDate": "2026-01-15T00:00:00.000Z",
"reviews": 894,
"marketplaceData": {
"shopee": {
"rating": 4.8,
"like": 1200,
"comment": 415,
"stock": 680,
"stockValue": 88332,
"location": "Kuala Lumpur"
}
}
}
],
"hasFullAccess": true,
"isLimited": false
}
}实用平台信号
响应包含标准化商品字段和平台专属数据，例如商品标识、URL、图片、价格、货币、评分、销量、营收及可用的店铺信息。
错误与使用限制
无效参数或凭据、方案权限、rate limit、上游处理和分页结束都会返回明确的 HTTP 错误。客户端应检查状态并遵守 Retry-After。
常见问题
哪些端点支持 Shopee？
GET /api/v1/products/search 和 GET /api/v1/products/category 均支持 Shopee。
哪个 country 值用于选择马来西亚？
使用 country=MY。该平台必须提供 country 参数。