Skip to main content

GET /v1/shopee/search/search_facets_v1

Shopee Search Facets API (V1)

stable · 39 credits per success

Retrieve the facets for a Shopee product search keyword.

Sign up for 500 credits and run with your own API key. Sign up free

Request

curl
curl -s 'https://api.wellbyte.net/v1/shopee/search/search_facets_v1?site=TW&keyword=%E5%92%96%E5%95%A1' \
  -H "Authorization: Bearer dg_live_…"

Response

Sample captured 2026-09-23

data{
code:0
data{
data{ 16 items }
site:"TW"
market:"Taiwan"
}
meta{
endpoint:"shopee.search.search_facets_v1"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

No calls yet. Get one green run first, then switch to your own data.

    Request parameters

    NameTypeInRequiredDescriptionExample
    sitestringqueryyesShopee 市场站点。 可用值: - `TW`:台湾 - `ID`:印度尼西亚 - `TH`:泰国TW
    keywordstringqueryyes商品搜索关键词。咖啡

    Response fields

    Field dictionary coming soon — the executable panel shows the live shape.

    Errors

    codeHTTPMeaningBilled
    40001400Invalid parametersno
    40102401Invalid or revoked API Keyno
    40201402Insufficient creditsno
    40402404Resource not foundno
    42201422Quality gate failedno
    42901429Rate limit exceededno
    50401504Upstream timeoutno
    50201502Upstream errorno

    Billing

    Success costs 39 credits. Any failure — including a 200 that fails the quality gate — costs 0.

    All Shopee endpoints →

    Search

    Search endpoints and docs