# Shopee (Brazil) — 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 on Shopee Brazil (shopee.com.br) and retrieve detailed information including item specifications, customer reviews, and seller profiles. Browse the complete category tree to discover products across all sections of the marketplace, and explore official shops, flash sales, and search suggestions.

**Category:** E-commerce | **Website:** [shopee.com.br/](https://shopee.com.br/) | **Docs:** [parse.bot/marketplace/5e75c2d6-2d44-4999-a883-67291f5c8dae/shopee-com-br-api](https://parse.bot/marketplace/5e75c2d6-2d44-4999-a883-67291f5c8dae/shopee-com-br-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-com-br-api-5e75c2d6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_tree

Get the full category hierarchy.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-com-br-api-5e75c2d6/get_category_tree \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_flash_sale_sessions

Get current flash sale sessions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-com-br-api-5e75c2d6/get_flash_sale_sessions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_official_shops

Get a paginated list of official/branded shops on Shopee Brazil. Returns shop names, numeric IDs, logos, and brand information. Supports offset-based pagination. The total field indicates total available official shops across all pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of shops to return per page (max observed: 20). |
| `offset` | integer | No | Pagination offset (number of shops to skip). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-com-br-api-5e75c2d6/get_official_shops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### get_product_comments

Get customer reviews for a product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filter` | integer | No | Rating filter (0: all, 1-5: stars) |
| `item_id` | string | Yes | Item ID |
| `limit` | integer | No | Number of reviews to return |
| `offset` | integer | No | Offset for pagination |
| `shop_id` | string | Yes | Shop ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-com-br-api-5e75c2d6/get_product_comments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter":"<integer>","item_id":"<string>","limit":"<integer>","offset":"<integer>","shop_id":"<string>"}'
```

### get_product_details

Get detailed information for a specific product. Note: Subject to aggressive anti-crawler protection.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Product Item ID |
| `shop_id` | string | Yes | Shop ID |

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

### get_search_hints

Get search keyword suggestions/autocomplete for a given keyword on Shopee Brazil. Returns related popular search terms that users frequently search for, useful for discovering trending products and refining searches. Each suggestion includes the keyword text, optional category binding, and a position rank.

**Estimated cost:** Metered

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

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

### get_shop_info

Retrieve detailed information about a shop/seller on Shopee Brazil including name, rating, follower count, item count, response rate, and shop rating breakdown. Requires a valid numeric shop_id which can be obtained from the get_official_shops endpoint. Returns the full shop profile as Shopee serves it — fields vary by shop configuration (decorated vs non-decorated, vacation mode, etc).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shop_id` | string | Yes | Numeric shop ID. Valid shop IDs can be obtained from the get_official_shops endpoint's shopid field. |

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

### search_products

Search for products on Shopee Brazil. Note: Subject to aggressive anti-crawler protection (error 90309999).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of items to return |
| `newest` | integer | No | Offset for pagination |
| `order` | string | No | Sort order (asc/desc) |
| `query` | string | Yes | Search keyword |
| `sort_by` | string | No | Sort criteria (relevancy, price, sales, rating) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopee-com-br-api-5e75c2d6/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","newest":"<integer>","order":"<string>","query":"<string>","sort_by":"<string>"}'
```