Shopee Scraper: Search Suggestions and Product Signals Across Shopee Markets

Get Shopee's own search suggestions for one or more keywords in 11 Shopee markets — suggested queries with the product and shop IDs and product images Shopee links to them — plus optional keyword hints, search filters and the full category tree.

What does this Shopee scraper do?

The Actor asks Shopee's public search-suggestion service for each keyword and writes one dataset row per suggested query. No browser, no proxy setup, results in seconds. Useful for:

• keyword and demand research per market
• finding the products and shops Shopee promotes for a query
• category and filter discovery (category tree, filter configuration)
• seeding product-ID lists for other tools

It does not return full product listings (prices, stock, sold counts): Shopee answers guest product searches with a login wall or a request-signature check, so this Actor sticks to the data Shopee serves openly.

Supported Shopee countries and regions

Market code	Country / region	Shopee domain
PH	Philippines	shopee.ph
SG	Singapore	shopee.sg
MY	Malaysia	shopee.com.my
TH	Thailand	shopee.co.th
TW	Taiwan	shopee.tw
VN	Vietnam	shopee.vn
ID	Indonesia	shopee.co.id
BR	Brazil	shopee.com.br
MX	Mexico	shopee.com.mx
CO	Colombia	shopee.com.co
CL	Chile	shopee.cl

You never configure a proxy: the hosted worker chooses the network route itself.

---

Features

• Shopee search suggestions per keyword and market (suggested query, linked item IDs, shop IDs, product images, ranking scores)
• Keyword hints with ranking fields in the SEARCH_SIGNALS record
• Optional search filter configuration (includeFilterConfig) and full category tree (includeCatTree, CATEGORY_TREE record)
• When Shopee has no suggestions for a keyword the run succeeds with 0 rows and says so (emptyReason: NO_MATCH)
• Pay-per-event pricing: low run start fee + per-result billing

Input

Field	Type	Required	Description
keyword	string	no	One keyword, for example phone case. Used when keywords is empty; default phone case.
keywords	string[]	no	Optional keyword list. Each keyword receives its own limit allowance and takes precedence over keyword.
market	string	no	Shopee country/region code. Default: SG.
limit	integer	no	Maximum Dataset rows per keyword. Default 70, max 200; the Console prefill is 3. Suggestions often top out at about 35 raw rows per keyword.
includeFilterConfig	boolean	no	Default false. Add the search filter tree to SEARCH_SIGNALS.
includeCatTree	boolean	no	Default false. Save the market's category tree to CATEGORY_TREE.

Example input

{
  "keywords": ["phone case", "wireless earbuds"],
  "market": "SG",
  "limit": 3
}

With the category tree and filters:

{
  "keyword": "wireless earbuds",
  "market": "MY",
  "includeFilterConfig": true,
  "includeCatTree": true
}

Output

One row per suggested query:

Every Dataset row now has rowType: "suggestion" and a stable id made from the normalized suggested keyword. limit is the maximum number of rows delivered and billed for each input keyword. Because Shopee has no row-plan input-list contract, the Actor submits one scalar worker plan per keyword. It explicitly calculates limit × keyword count, bounds that total by the free-plan and maximum-charge budgets, and uses the same total cap for worker acquisition and Dataset push. Linked item, shop, and image lists remain attributes of the suggestion and are capped at 50 values with total counts.

Field	Description
title / query	The suggested search query
record_type	search_suggestion
item_id, shop_id, product_url	The first product Shopee links to the suggestion
suggestion_item_ids, suggestion_shop_ids, suggestion_images	All linked products, shops and images
suggestion_tracking	Ranking signals (rank_score, model_scores, …) when present
market, market_name, market_host, country, keyword, rank	Context
price, sold_text, rating_text	Empty: suggestions carry no prices

Example output item (suggestions)

{
  "market": "SG",
  "market_name": "Singapore",
  "market_host": "shopee.sg",
  "keyword": "phone case",
  "rank": 1,
  "title": "iPhone 18 Pro",
  "query": "iPhone 18 Pro",
  "record_type": "search_suggestion",
  "item_id": "57717808852",
  "shop_id": "1234567",
  "product_url": "https://shopee.sg/product/1234567/57717808852",
  "image": "https://cf.shopee.sg/file/sg-11134301-825ac-msx6rmw8pt6yaf",
  "price": "",
  "source": "suggestion_api"
}

Key-value store records

Key	Content
RUN_SUMMARY	Outcome, row count, emptyReason, worker notes and diagnostics
SEARCH_SIGNALS	Keyword hints with ranking fields, optional filterConfiguration
CATEGORY_TREE	market, rootCount, totalNodeCount, categories (with includeCatTree)

Pricing

This Actor uses Pay per event pricing.

Event	Event name	Price
Actor Start	apify-actor-start	$0.005 per run
Result	apify-default-dataset-item	$3.00 / 1,000 results ($0.003 each)

User pays platform usage costs: No. Compute and proxy usage are included in the Actor event price.

Tiered pricing by Apify subscription:

Tier	$/1,000	per result
FREE*	$3.00	$0.003
BRONZE	$3.00	$0.003
SILVER	$2.60	$0.0026
GOLD	$2.20	$0.0022
PLATINUM	$2.00	$0.002
DIAMOND	$1.60	$0.0016

Example: 1,000 product rows cost $0.005 start + $3.00 result events (FREE/BRONZE), down to $1.60 / 1,000 on DIAMOND. Platform usage is included.

More Actors like this

Need another marketplace or a different vertical? Use a dedicated Actor below for structured fields. Use this Actor for Shopee search across supported markets.

Similar e-commerce scrapers

• Lazada Scraper
• Amazon Search Scraper
• SHEIN Product Scraper
• Temu Product Scraper
• MercadoLibre Scraper
• 1688 Global Product Search Scraper
• Coupang Product Scraper
• Walmart Product Scraper
• Etsy Scraper
• Target Product Scraper
• Allegro Scraper
• Mercari Japan Scraper

Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

Jobs & Freelance

• LinkedIn Jobs Scraper
• Indeed Jobs Scraper
• Upwork Jobs Scraper
• Glassdoor Scraper
• Fiverr Gigs Scraper
• Bayt Jobs Scraper

Real Estate

• Zillow & Zumper Scraper
• Realtor.com Scraper
• Apartments.com Rental Scraper
• Rightmove Scraper
• Idealista Scraper
• realestate.com.au Scraper

Travel & Stays

• Booking.com Hotels Scraper
• Airbnb Listings Scraper
• Expedia Scraper
• TripAdvisor Scraper

Social & Content

• YouTube Research Scraper
• TikTok Scraper
• Reddit Scraper
• YouTube Shorts Scraper

Ads Intelligence

• Facebook Ad Library Scraper
• TikTok Ads Scraper

Local & Maps

• Google Maps Scraper

General tools

• Stealth Web Scraper
• Email Risk Validator
• Phone Number Intelligence

→ See the full catalog in Related Actors below, or browse apify.com/lentic_clockss.

---

How to get Shopee search suggestions

1. Open the Actor on Apify.
2. Enter a keyword or a keywords list.
3. Select the target market.
4. Set limit; tick includeFilterConfig / includeCatTree if you want them.
5. Run the Actor.
6. Export the dataset as JSON, CSV, Excel, XML, RSS, or HTML.

Free Apify plan limits (set by this Actor's developer)

Limit	Free Apify plan	Paid Apify plan
Runs of this Actor	10 runs total	Unlimited
Results per run	Up to 200	Up to schema max (200)

When the run cap is hit, the run finishes with a clear status message — not an Apify platform error.

Worker URL is config, not code: the Actor reads WORKER_BASE_URL from Actor environment variables (plus optional per-run workerBaseUrl). If you migrate the worker to a new host, update WORKER_BASE_URL (and WORKER_AUTH if the API key changes) in Apify Console — no Actor code change required. Set WORKER_PROVIDES_PROXY=1 when the worker supplies its own proxy / Bright Data stack.

Notes and limitations

• No product listings: Shopee answers guest product searches with a login wall or a signature check.
• You do not need or pass a proxy; the hosted worker handles routing.
• Some markets may return fewer visible results for certain keywords.
• Rows are search signals, not matching product listings. Shopee may return general recommendations unrelated to the input keyword. query is the suggested text, title is its compatibility alias, and record_type=search_suggestion. Unknown price is an empty string, not zero; sold count and rating stay empty.
• Signal rows retain suggestion_item_ids, suggestion_shop_ids, suggestion_images, and suggestion_tracking (available ranking/model scores). SEARCH_SIGNALS contains keyword hints with ranking fields and, when requested, filterConfiguration. With includeCatTree, CATEGORY_TREE holds the market's category tree (market, rootCount, totalNodeCount, categories with catid, parent_catid, name, display_name, images, level and nested children; SG has 27 roots and 260+ nodes). Missing auxiliary data is reported via hintError, filterConfigError or catTreeError.
• RUN_SUMMARY includes signal counts and data-quality diagnostics. Malformed suggestion rows are skipped and counted as contractDropped. When Shopee returns no suggestions at all the run succeeds with 0 rows and emptyReason: NO_MATCH; when every returned row is malformed the run fails.
• The Actor extracts public search-result information; use the data responsibly and respect applicable laws and Shopee terms.

FAQ

Why did my free-plan run stop with a limit message?

Free Apify plan users can run this Actor up to 10 times, with up to 200 results per run. These caps are set by the Actor developer, not Apify. Upgrade to a paid Apify plan for unlimited runs (schema limit still applies per keyword).

Which Shopee countries are supported?

Philippines, Singapore, Malaysia, Thailand, Taiwan, Vietnam, Indonesia, Brazil, Mexico, Colombia, and Chile.

Do I need to choose a proxy country?

No. Select the Shopee market; the hosted worker picks the network route. Proxy settings are not part of the input.

Can I run it on a schedule?

Yes. Use Apify schedules to monitor keywords over time for price tracking, competitor monitoring, or product research.

Can I use it from code?

Yes. You can run the Actor from the Apify API, the Apify JavaScript/Python clients, CLI, integrations, or MCP tools.

Is this a Shopee API?

It is not an official Shopee API. It reads Shopee's public search-suggestion data and returns it as structured rows.

Related Actors

All 77 public Actors from [lentic_clockss]. Click a name to open the Store detail page.

Jobs & Freelance

• LinkedIn Jobs Scraper
• Bayt Jobs Scraper
• Fiverr Gigs Scraper
• Freelancer.com Scraper
• Glassdoor Scraper
• Himalayas Jobs Scraper
• Indeed Jobs Scraper
• Jobicy Remote Jobs Scraper
• RemoteOK Jobs Scraper
• SEEK Jobs Scraper
• Upwork Jobs Scraper

Real Estate

• Zillow & Zumper Scraper
• Realtor.com Scraper
• 99.co Scraper
• Realtor.com Agents Scraper
• Apartments.com Rental Scraper
• Bayut Scraper
• Craigslist Housing Scraper
• Daft.ie Scraper
• Dot Property Scraper
• FINN.no Scraper
• Funda Scraper
• Hepsiemlak Scraper
• Idealista Scraper
• Immobiliare.it Scraper
• ImmoScout24 Scraper
• Naver Land Scraper
• OpenSooq Scraper
• Otodom Scraper
• Property Finder Scraper
• PropertyGuru Scraper
• realestate.com.au Scraper
• Realtor.ca Scraper
• Rightmove Scraper
• SeLoger Scraper
• SUUMO Scraper
• Zillow Group Scraper

E-commerce

• Shopee Search Scraper
• E-commerce Scraper
• 1688 Global Product Search Scraper
• Allegro Scraper
• Amazon Search Scraper
• ASOS Product Scraper
• Cdiscount Product Scraper
• Costco Product Scraper
• Coupang Product Scraper
• Etsy Scraper
• Lazada Scraper
• MercadoLibre Scraper
• Mercari Japan Scraper
• Rakuten Japan Scraper
• SHEIN Product Scraper
• Target Product Scraper
• Temu Product Scraper
• Walmart Product Scraper

Travel & Stays

• Booking.com & Airbnb Scraper
• Agoda Scraper
• Airbnb Listings Scraper
• Booking.com Hotels Scraper
• Despegar Scraper
• Expedia Scraper
• Traveloka Scraper
• Travelstart Flights Scraper
• Trip.com Scraper
• TripAdvisor Scraper

Social & Content

• TikTok Scraper
• Reddit Scraper
• YouTube Shorts Scraper
• YouTube Research Scraper
• Hacker News Scraper

Ads Intelligence

• Facebook Ad Library Scraper
• Google Ads Transparency VN
• TikTok Ads Scraper

Local & Maps

• Google Maps Scraper

General Tools

• Stealth Web Scraper
• Email Risk Validator
• Phone Number Intelligence

→ Browse the full profile: apify.com/lentic_clockss