# Shopee (Vietnam) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for products and shops on Shopee Vietnam, view detailed product information and shop profiles, and get search suggestions to discover items. Find everything you need with access to product listings, pricing, descriptions, and merchant details from Vietnam's leading marketplace.

**Category:** Marketplaces | **Website:** [shopee.vn/](https://shopee.vn/) | **Docs:** [parse.bot/marketplace/3675a518-ed99-43e3-a552-6cb297e51ad9/shopee-vn-api](https://parse.bot/marketplace/3675a518-ed99-43e3-a552-6cb297e51ad9/shopee-vn-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-shopee-vn-api-3675a518/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_detail

Get full details for a specific product. NOTE: This endpoint may return error 90309999 (anti-bot block) if not authenticated.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Unique ID of the item |
| `shop_id` | string | Yes | Unique ID of the shop |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-vn-api-3675a518/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>","shop_id":"<string>"}'
```

### get_search_suggestions

Get search suggestions for a keyword prefix. Returns suggested queries with associated item IDs, shop IDs, images, and hint text. Each suggestion includes a display text, image references, and linked item/shop identifiers. The response includes a has_more flag and session metadata for tracking.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword prefix to get suggestions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-vn-api-3675a518/get_search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>"}'
```

### get_shop_info

Get shop profile information by numeric shop ID. Returns shop name, follower count, rating star, item count, response rate, account details (username, portrait), vacation status, and shop configuration including A/B test flags and tab visibility.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shop_id` | string | Yes | Numeric shop ID of the Shopee shop. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-vn-api-3675a518/get_shop_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shop_id":"<string>"}'
```

### search_products

Search for products by keyword. NOTE: This endpoint may return error 90309999 (anti-bot block) if not authenticated.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `by` | string | No | Sort field (relevancy, price, sales, rating) |
| `keyword` | string | Yes | Search keyword |
| `limit` | integer | No | Max results to return |
| `offset` | integer | No | Results offset for pagination |
| `order` | string | No | Sort order (asc, desc) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-vn-api-3675a518/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"by":"<string>","keyword":"<string>","limit":"<integer>","offset":"<integer>","order":"<string>"}'
```