# Shopee Search API (shopee.search)

- Canonical page: [https://everyinfra.com/en/shopee-api/search](https://everyinfra.com/en/shopee-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "shopee", "action": "search", "params": {...}}
- Price: $0.006403 per call ($6.4 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

Shopee Search finds products in one Shopee marketplace by `keyword` and returns each listing's name, link, image, price and original price with the discount percentage and currency, rating and rating count, units sold, location, whether it is a Shopee Mall store, and the shop and item IDs. Sellers, brands and market researchers working across Shopee's countries use it to map a category, compare prices across shops and track competitors.

`country` picks the marketplace and defaults to Indonesia, so set it for every other market, and remember that prices and price filters use that market's currency. `is_mall` marks official Shopee Mall stores, the first thing to check where counterfeits are a concern. `location` is passed through as Shopee shows it, and a null `rating_count` means Shopee keeps the number private; read it as unknown, not zero. `sort` orders by `relevance`, `popular`, `newest` or price in either direction.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=shopee&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies product search keywords for `search`. The target regional marketplace is determined by `country`. |
| country | enum: br / cl / co / id / mx / my / ph / sg / th / tw / vn | no | not declared | Sets the region code and takes precedence over `region` and URL inference. For `search`, `profile`, and `shop`, defaults to `id` (Indonesia) when unspecified. Configured domain detection includes `sg`, `my`, `th`, `ph`, `vn`, `br`, `tw`, `mx`, `co`, and `cl`, though a recognized domain does not guarantee data for every region. `product_detail` usually reads the region from the product URL. |
| max_price | not declared | no | not declared | Sets the maximum item price using the target marketplace's price scale. Use it with min_price to define a range. Filtering uses whole numbers: decimals round up (145.98 becomes 146). |
| min_price | not declared | no | not declared | Sets the minimum item price for `search` based on the target market's currency scale. Do not assume values represent the same currency across regions. This parameter does not represent API billing amounts. Filtering uses whole numbers: decimals round down (39.81 becomes 39). |
| sort | enum: newest / popular / price_asc / price_desc / relevance | no | not declared | Sorts product search results for `search`. Allowed values are `relevance`, `popular` (sales-based), `newest`, `price_asc`, and `price_desc`. This parameter is not used for `shop` listings or product details. |
| limit | integer (1–100) | no | 20 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| shop_id | platform-native meaning |
| item_id | platform-native meaning |
| name | Name of the object itself, for account, product and business capabilities. |
| url | Link to the record on the platform. |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| price | Price as a number without a currency symbol; see currency. For product detail (product_detail), a call that returns no price is not charged; the other fields still come back. |
| original_price | platform-native meaning |
| discount_pct | platform-native meaning |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| rating_count | Number of people who rated. null means not disclosed, not 0. |
| sold_count | platform-native meaning |
| location | Location description passed through as is; the format varies by platform. |
| is_mall | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "shopee",
  "action": "search",
  "params": {
    "keyword": "wireless mouse"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "shopee",
        "action": "search",
        "params": {
            "keyword": "wireless mouse",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "shopee",
  "action": "search",
  "results": [
    {
      "shop_id": 487136590,
      "item_id": 23911735997,
      "name": "MOFii Mouse Wireless Gaming Rechargeable Baterai Type-C Fast Charging 1600DPI RGB Light P6",
      "url": "https://shopee.co.id/MOFii-Mouse-Wireless-Gaming-Rechargeable-Baterai-Type-C-Fast-Charging-1600DPI-RGB-Light-P6-i.487136590.23911735997",
      "image_url": "https://down-id.img.susercontent.com/file/id-11134207-7qul0-li9nrexr1rvb70",
      "price": 80000,
      "original_price": 299900,
      "currency": "IDR",
      "rating": 4.9,
      "location": "Tangerang",
      "is_mall": false,
      "platform": "shopee",
      "rating_scale": 5
    },
    {
      "shop_id": 992148841,
      "item_id": 25190075617,
      "name": "[COD] Mouse Bluetooth Dual-Mode Wireless 2.4G Silent Mouse USB Portable Charging Gaming Mouse For IPad Windows los",
      "url": "https://shopee.co.id/-COD-Mouse-Bluetooth-Dual-Mode-Wireless-2.4G-Silent-Mouse-USB-Portable-Charging-Gaming-Mouse-For-IPad-Windows-los-i.992148841.25190075617",
      "image_url": "https://down-id.img.susercontent.com/file/id-11134207-7rbke-m8vjok4qdvcr7f",
      "price": 30900,
      "original_price": 58000,
      "currency": "IDR",
      "rating": 4.9,
      "location": "Jakarta Barat",
      "is_mall": false,
      "platform": "shopee",
      "rating_scale": 5
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Which marketplace does a search cover?

One per call, set by `country`: `id` for Indonesia (the default), `sg`, `my`, `th`, `ph`, `vn`, `tw`, `br`, `mx`, `co` or `cl`. To compare a product across markets, run one search per country and keep `currency` with every row. A market with no matching listings returns no rows, and such a call is not charged.

### How do I reach the full product page or the shop behind a result?

Each row carries `item_id` and `shop_id`. Pass the product's `url` to Shopee Product details for the full description, stock, variants and shop location. Pass `shop_id`, with the same `country`, to Shopee Shop to list the rest of that shop's products.

### How do the price filters work across countries?

`min_price` and `max_price` use the currency of the market you search, the same one each row reports in `currency`. A price band that suits Singapore will not fit Indonesia or Vietnam, so set the filters per market. To see how deep a promotion goes, read `discount_pct` together with `original_price` and `price`.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=shopee
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
