# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/shopee-vietnam/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/shopee-vietnam/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/shopee-vietnam/get-search-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/shopee-vietnam/get-shop-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/shopee-vietnam/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"by":"<string>","keyword":"<string>","limit":"<integer>","offset":"<integer>","order":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.