Regional category mapping
Use Shopee endpoints to turn regional category mapping into repeatable API requests with documented inputs and JSON responses.
Explore local category and search-navigation data while keeping promotional snapshots distinct from product search results and seller records.
Map Shopee's regional category trees, search controls, suggestions, banners, and storefront navigation as structured JSON.
Endpoint families
6
Documented params
30
Examples
11
Live catalog snapshot
Active endpoints
11
Methods
GET
Required params
14
Schema refs
11
{
"platform": "Shopee",
"endpoint": "shopee-categories",
"method": "GET",
"path": "/shopee/categories",
"auth": "apiKey"
}Use cases
Map Shopee's regional category trees, search controls, suggestions, banners, and storefront navigation as structured JSON.
Use Shopee endpoints to turn regional category mapping into repeatable API requests with documented inputs and JSON responses.
Use Shopee endpoints to turn localized search-filter research into repeatable API requests with documented inputs and JSON responses.
Use Shopee endpoints to turn storefront banner and navigation snapshots into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Shopee endpoint catalog — 11 endpoints, 30 documented request parameters, and 11 published response schemas — the same catalog Docs and Playground run against.
11 documented Shopee endpoints, grouped into 11 request families — Banners, Categories and Category Detail, plus 8 more.
30 request parameters are documented across those Shopee endpoints, 14 of them required — the full input contract is public before you write any integration code.
11 of the 11 Shopee endpoints ship a recorded example response, and 11 carry a documented response schema — you can code against the real JSON before the first request.
Shopee endpoints document their error responses (400, 429, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
11 hosted MCP tools back the Shopee endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/shopee/banners
/shopee/categories
/shopee/category-detail
/shopee/footer
/shopee/home-categories
/shopee/location-filters
Endpoint catalog
/shopee/categoriesReturns the full public category/navigation tree from Shopee's credential-free `api/v4/pages/get_category_tree` JSON. Public, credential-free endpoint.
Sampled 29 Oct 2026: 25 items, 5 fields filled in every item, 1 not. name: “Mobile & Accessories” and 24 other values; image: cf.shopee.com.my.
MCP tool shopee_categories
/shopee/home-categoriesReturns the homepage category tiles from the credential-free `api/v4/pages/get_homepage_category_list` JSON. Public, credential-free endpoint.
Sampled 29 Oct 2026: 25 items, 5 fields filled in every item. name: “Mobile & Accessories” and 24 other values; image: cf.shopee.com.my.
MCP tool shopee_home_categories
/shopee/mall-categoriesReturns the official-shop (mall) category directory from Shopee's credential-free `api/v4/official_shop/get_categories` JSON. Public, credential-free endpoint.
Sampled 29 Oct 2026: 24 items, 3 fields filled in every item. name: “Muslim Fashion” and 23 other values; image: cf.shopee.com.my.
MCP tool shopee_mall_categories
/shopee/category-detailReturns localized names, parent chain and images for up to 20 category ids from the credential-free `api/v4/search/get_fe_category_detail` JSON. Public, credential-free endpoint.
MCP tool shopee_category_detail
/shopee/location-filtersReturns the "Shipped From" location facet groups and tag ids from the credential-free `api/v4/search/location_filter` JSON. Public, credential-free endpoint.
Sampled 29 Oct 2026: 11 items, 6 fields filled in every item. group: “E” and 10 other values; locations: median 1 entry.
MCP tool shopee_location_filters
/shopee/search-filtersReturns the server-driven filter groups (locations, shipping, shop type, brands, category facets, payment, rating, condition) for a keyword or category context from the credential-free `api/v4/search/search_filter_config` JSON. Public, credential-free endpoint.
Sampled 29 Oct 2026: 10 items, 3 fields filled in every item, 2 not. ui_type: 1 to 9, median 1; name: “LOCATIONS” and 9 other values.
MCP tool shopee_search_filters
/shopee/search-hintsReturns server-ranked keyword hints for a prefix from the credential-free `api/v4/search/search_hint` JSON (distinct from search-suggestion: hint-panel keywords with rank/category metadata). Public, credential-free endpoint.
Sampled 29 Oct 2026: 12 items, 1 field filled in every item, 2 not. position: 5 to 32, median 12; keyword: “phone murah” and 11 other values.
MCP tool shopee_search_hints
/shopee/suggestReturns Shopee search autocomplete suggestions for a keyword prefix from the credential-free `api/v4/search/search_suggestion` JSON. Public, credential-free endpoint.
MCP tool shopee_suggest
/shopee/prefillsReturns Shopee's search-landing prefill/trending cards from the credential-free `api/v4/search/search_prefills` JSON. Public, credential-free endpoint.
Sampled 29 Oct 2026: 1 item, 3 fields filled in every item. hint: “Sign Up & Get Your First Order Free!”; image: cf.shopee.com.my.
MCP tool shopee_prefills
/shopee/bannersReturns homepage merchandising banners for one slot from the credential-free `api/v4/banner/batch_list_by_spaces` POST JSON. Public, credential-free endpoint.
Sampled 29 Oct 2026: 3 items, 7 fields filled in every item. start_time: 2026-10-25; image: cf.shopee.com.my.
MCP tool shopee_banners
/shopee/footerReturns the site footer/navigation layout (help topics, about, payment/logistics partners, social links, app download) from the credential-free `api/v4/pages/get_footer_layout` JSON. Public, credential-free endpoint.
Sampled 29 Oct 2026: 5 items, 1 field filled in every item. sections: median 1 entry.
MCP tool shopee_footer
Related APIs
Marketplaces & Retail
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
How to scrape Shopee
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.
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.
`/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.
`/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.
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.
`/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.
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.
FAQ
No. The selected public routes expose category trees, search controls, suggestions, and storefront modules. The current public catalog has no item-search result, product-detail, or product-review operation.
No. The full category tree, homepage shortcuts, and Mall directory are separate source taxonomies. Keep the originating region and directory with every ID before requesting category detail.
It is Shopee's own seller classification, not an independent check. Shopee says Mall sellers are verified, while its product-safety guidance also warns counterfeit listings can be missed; keep the source label and evidence separate.
This landing does not recommend those routes. Shopee's Community Guidelines prohibit automated scripts from collecting information about other Shopee users, and those responses include seller/shop identifiers. Do not use them to build bulk seller datasets without explicit authorization.
Some marketplace modules are not available in every regional storefront. The current source notes upstream errors for specific category and location surfaces in Chile or Colombia; preserve the error and region rather than recording a zero-category result.