Shopee API Documentation

Map Shopee's regional category trees, search controls, suggestions, banners, and storefront navigation as structured JSON. 11 endpoints documented below.

Try Get the Shopee category tree Start with endpoint docs Pricing

First request

Endpoint: GET /shopee/categories
Cost: 1 credit/request

curl -X GET "https://api.crawlora.net/api/v1/shopee/categories?region=my" \
  -H "x-api-key: $CRAWLORA_API_KEY"

API key authentication Error handling guide Rate limits and credits Shopee Regional Marketplace API

How to use Shopee endpoints

Shopee is Sea Limited's e-commerce marketplace, and its own product overview says the service is tailored to each market. The public Crawlora surface is storefront navigation, not a product-search API: it has no public item-result, product-detail, or product-review route. On 2026-10-29, Shopee Malaysia's category tree returned 25 top-level nodes and the separate home-category list returned 25 entries. A search-filter request with `keyword=headphones` returned 10 filter groups and 6 shortcuts; it described the available controls but did not return products or sorting options. Keep the region and taxonomy source with each snapshot: the full category tree, home shortcuts, and Shopee Mall categories are distinct directories. Shopee describes Mall as a dedicated space for well-known local and international brands, but its own product-safety guidance says counterfeit listings can be missed. Preserve the Mall label as Shopee's classification, not independent authenticity proof. Shopee's Community Guidelines also prohibit automated scripts collecting information about other users. This landing therefore omits the shop directory/profile, homepage live-session, and flash-sale routes whose responses contain shop identifiers; do not use them to build seller or user datasets.

Step 1
Choose a local storefront region
Every selected route accepts a region code; the current set is `my`, `sg`, `id`, `th`, `vn`, `ph`, `tw`, `br`, `mx`, `co`, and `cl`, with `my` as the default. Save the code with each response because storefront content and supported modules vary by market.
Step 2
Keep the category directories separate
`/shopee/categories` returns the nested category tree, `/shopee/home-categories` returns homepage shortcuts, and `/shopee/mall-categories` returns Mall-specific categories. The Malaysia calls returned 25 top-level entries from each of the first two directories on 2026-10-29; category IDs and labels are not interchangeable across these surfaces.
Step 3
Read search controls without treating them as results
`/shopee/search-filters` requires either a `keyword` or a category ID. A live `keyword=headphones` request returned 10 filter groups and 6 shortcuts. `/shopee/suggest`, `/shopee/search-hints`, and keyword-free `/shopee/prefills` serve different discovery panels; none returns item search results, and the search-filter route does not expose sort keys.
Step 4
Use IDs only with their source directory
Pass `catids` from `/shopee/categories` into `/shopee/category-detail`; it accepts at most 20 IDs. `/shopee/location-filters` exposes market-specific labels and tag IDs. Some category and location operations return an upstream error in Chile or Colombia; an HTTP 503 is not an empty taxonomy.
Step 5
Capture navigation and campaign placement separately
`/shopee/banners` accepts a documented slot or a raw `space_key`, while `/shopee/footer` returns the market's help, payment, logistics, and social link layout. Retain the requested region, slot, and fetch time; these are changing storefront placements, not product inventory or transaction history.
Step 6
Respect Shopee's user-data boundary
Shopee's Community Guidelines prohibit automated scripts from collecting information about other Shopee users. Shop-directory/profile, homepage live-session, and flash-sale responses contain shop identifiers, so this landing excludes those routes from its collection workflow. Do not build seller or user datasets from those responses without explicit authorization.

Shopee API endpoints

GET/shopee/bannersapiKey2 credits/request

Get Shopee homepage banners

Returns homepage merchandising banners for one slot from the credential-free `api/v4/banner/batch_list_by_spaces` POST JSON. Public, credential-free endpoint.

Optional: region (11 allowed values: my, sg, id, th, vn, ph, tw, br, mx, co, cl), slot (6 allowed values: HOME_CAROUSEL_01, HOME_SKINNY_01, HOME_NUZ_CAROUSEL_01, HOME_FLOATING, HOME_POPUP_01, HOME_MALL_01), space_key.

Sampled 29 Oct 2026: 3 items. Filled in every item: banner_id, campaign_unit_id, slot_id, image, url, start_time, end_time. In the sample: start_time: 2026-10-25; image: cf.shopee.com.my; url: shopee.com.my; end_time: 2026-10-31.

Shopee API Documentation

First request

How to use Shopee endpoints

Choose a local storefront region

Keep the category directories separate

Read search controls without treating them as results

Use IDs only with their source directory

Capture navigation and campaign placement separately

Respect Shopee's user-data boundary

Shopee API endpoints

Other Marketplaces & Retail APIs

Shopee API Documentation

First request

How to use Shopee endpoints

Choose a local storefront region

Keep the category directories separate

Read search controls without treating them as results

Use IDs only with their source directory

Capture navigation and campaign placement separately

Respect Shopee's user-data boundary

Shopee API endpoints

Other Marketplaces & Retail APIs