Shopee Search Keyword Suggestions

Fetch Shopee's keyword autocomplete suggestions for any search prefix — the same ranked terms that appear in the search bar dropdown when users type on Shopee.

Why use this actor

• Zero cost keyword research — discover what real Shopee shoppers are searching for
• All 11 Shopee regions — localized suggestions for ID, SG, MY, TH, PH, VN, and more
• Batch mode — submit multiple seed keywords in one run
• No account or login required — no credentials, no API key needed
• Stable JSON output — clean structured data, no HTML parsing

How it works

1. You provide a keyword prefix (e.g. "laptop") and a country.
2. The actor calls Shopee's search suggestion API — the same endpoint that powers the live autocomplete dropdown.
3. Up to 12 ranked keyword suggestions are returned per input, in the local language.
4. Results stream into your dataset as JSON.

Input

{
  "country": "id",
  "keyword": "laptop"
}

Batch mode — multiple keywords in one run:

{
  "country": "id",
  "keywords": ["laptop", "handphone", "sepatu"]
}

Field	Type	Description
keyword	string	Single search prefix to expand into suggestions.
keywords	array	Multiple search prefixes for batch processing. Each returns up to 12 suggestions.
country	string	Shopee regional site: id (default), sg, my, th, ph, vn, br, tw, mx, co, cl

Provide either keyword (single) or keywords (batch), or both. Always returns exactly 12 suggestions per input regardless of the limit parameter (Shopee API behaviour).

Output

[
  {
    "keyword": "laptop murah",
    "rank_position": 5,
    "category_id": 0,
    "category_name": "",
    "source_keyword": "laptop",
    "country": "id"
  },
  {
    "keyword": "laptop",
    "rank_position": 0,
    "category_id": 0,
    "category_name": "",
    "source_keyword": "laptop",
    "country": "id"
  },
  {
    "keyword": "laptop asus",
    "rank_position": 4,
    "category_id": 0,
    "category_name": "",
    "source_keyword": "laptop",
    "country": "id"
  },
  {
    "keyword": "laptop gaming",
    "rank_position": 8,
    "category_id": 0,
    "category_name": "",
    "source_keyword": "laptop",
    "country": "id"
  },
  {
    "keyword": "laptop acer",
    "rank_position": 14,
    "category_id": 0,
    "category_name": "",
    "source_keyword": "laptop",
    "country": "id"
  }
  // ... 7 more
]

Field	Type	Description
keyword	string	The suggested search term
rank_position	integer	Shopee's internal rank score for this suggestion (lower = higher priority)
category_id	integer	Category ID if the suggestion is category-specific (0 = all categories)
category_name	string	Human-readable category name, or empty string
source_keyword	string	The input prefix that generated this suggestion
country	string	Shopee region code

Other Shopee Actors

Actor	What it does
../shopee-search-act	Keyword + category search across all sellers
../shopee-mall-search	Official brand store search (Shopee Mall)
../shopee-detail-act	Full product detail by shop/item ID or URL
../shopee-shop-act	All products from a specific Shopee shop
../shopee-campaign	Products from Shopee campaign microsites
../shopee-flash-sale	Current flash sale session products