# Shopee (Philippines) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 and browse Shopee Philippines products, view detailed product information with customer reviews, and discover shop details and inventory. Access product search suggestions and explore the full category tree to find what you're looking for on the marketplace.

**Category:** Marketplaces | **Website:** [shopee.ph/](https://shopee.ph/) | **Docs:** [parse.bot/marketplace/3c6bf85c-df91-482a-98b1-4c975e89a02a/shopee-ph-api](https://parse.bot/marketplace/3c6bf85c-df91-482a-98b1-4c975e89a02a/shopee-ph-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/shopee-philippines/`
**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 category tree

Fetch the complete category hierarchy for the marketplace. NOTE: This endpoint currently requires authentication (Shopee login) and will return an error for unauthenticated requests.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/shopee-philippines/get-category-tree \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get product details

Retrieve full product details. NOTE: This endpoint currently requires authentication (Shopee login) and will return an error for unauthenticated requests.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Shopee item ID |
| `shop_id` | string | Yes | Shopee shop ID |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/shopee-philippines/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>","shop_id":"<string>"}'
```

### Get product reviews

Fetch customer reviews for a specific product. NOTE: This endpoint currently requires authentication (Shopee login) and will return an error for unauthenticated requests.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Shopee item ID |
| `limit` | integer | No | Max reviews to return |
| `offset` | integer | No | Pagination offset |
| `shop_id` | string | Yes | Shopee shop ID |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/shopee-philippines/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>","limit":"<integer>","offset":"<integer>","shop_id":"<string>"}'
```

### Get search suggestions

Retrieve search suggestions and related trending item previews for a keyword on Shopee Philippines. Returns popular search queries related to the input along with associated item IDs, thumbnail images, shop IDs, and display hints for each suggestion. Useful for autocomplete, keyword research, and discovering related product categories.

**Estimated cost:** Metered

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

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/shopee-philippines/get-search-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Get shop info

Retrieve comprehensive public seller/shop profile data from Shopee Philippines. Returns shop name, star ratings, follower count, item count, response rate and time, location, verification status, and account metadata. The shop must be identified by its numeric shop ID (visible in Shopee URLs or from search suggestion shop_ids).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shop_id` | string | Yes | Numeric Shopee shop ID (e.g. '1387686415'). Available from get_search_suggestions results in the shop_ids arrays. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/shopee-philippines/get-shop-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"shop_id":"<string>"}'
```

### Get shop products

List products from a specific shop. NOTE: This endpoint currently requires authentication (Shopee login) and will return an error for unauthenticated requests.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results |
| `offset` | integer | No | Pagination offset |
| `shop_id` | string | Yes | Shopee shop ID |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/shopee-philippines/get-shop-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","shop_id":"<string>"}'
```

### Search products

Search for products by keyword on Shopee Philippines. NOTE: This endpoint currently requires authentication (Shopee login) and will return an error for unauthenticated requests.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `offset` | integer | No | Pagination offset |
| `query` | string | Yes | Search keyword |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/shopee-philippines/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```

## Next steps

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