# Shopee (Philippines) — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-shopee-ph-api-3c6bf85c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-shopee-ph-api-3c6bf85c/get_category_tree \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-shopee-ph-api-3c6bf85c/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-shopee-ph-api-3c6bf85c/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-shopee-ph-api-3c6bf85c/get_search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-shopee-ph-api-3c6bf85c/get_shop_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-shopee-ph-api-3c6bf85c/get_shop_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-shopee-ph-api-3c6bf85c/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```