# Tiki — 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 products from Tiki.vn with instant access to detailed product information, customer reviews, category listings, and seller profiles. Discover items across categories, compare products, read customer feedback, and learn about sellers all in one place.

**Category:** E-commerce | **Website:** [tiki.vn/](https://tiki.vn/) | **Docs:** [parse.bot/marketplace/714861fa-a5b0-4242-890c-59888a2fb472/tiki-vn-api](https://parse.bot/marketplace/714861fa-a5b0-4242-890c-59888a2fb472/tiki-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-tiki-vn-api-714861fa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Get detailed information about a specific product including description, images, specifications, seller, pricing, and warranty info. The product_id can be obtained from search_products or get_products_by_category results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | The unique ID of the product. |
| `spid` | string | No | The seller product ID for accurate pricing of a specific variant. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tiki-vn-api-714861fa/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","spid":"<string>"}'
```

### get_product_reviews

Fetch customer reviews for a specific product. Returns paginated reviews with ratings, content, images, and reviewer info. The product must have reviews for data to appear.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of reviews per page. |
| `page` | integer | No | Page number. |
| `product_id` | string | Yes | The unique ID of the product. |
| `seller_id` | string | No | Filter reviews by seller ID. |
| `sort` | string | No | Sort order for reviews. |
| `spid` | string | No | The seller product ID to filter reviews for a specific variant. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tiki-vn-api-714861fa/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","product_id":"<string>","seller_id":"<string>","sort":"<string>","spid":"<string>"}'
```

### get_products_by_category

List products within a specific category. Returns paginated results with optional price and rating filters. Category IDs can be found from product details breadcrumbs or known categories like 1846 (Laptop & Computer).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | The ID of the category (e.g. 1846 for Laptop & Computer, 1789 for Phone & Tablet, 8322 for Fashion). |
| `limit` | integer | No | Number of items per page. |
| `page` | integer | No | Page number. |
| `price_max` | integer | No | Maximum price filter in VND. |
| `price_min` | integer | No | Minimum price filter in VND. |
| `rating` | integer | No | Minimum rating filter (3, 4, or 5). |
| `sort` | string | No | Sort order. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tiki-vn-api-714861fa/get_products_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","limit":"<integer>","page":"<integer>","price_max":"<integer>","price_min":"<integer>","rating":"<integer>","sort":"<string>"}'
```

### get_products_by_seller

List products from a specific seller. Returns paginated results sorted by popularity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of items per page. |
| `page` | integer | No | Page number. |
| `seller_id` | string | Yes | The unique ID of the seller. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tiki-vn-api-714861fa/get_products_by_seller \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","seller_id":"<string>"}'
```

### get_seller_info

Get information about a seller/store including ratings, follower count, and store badge. Returns seller profile details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | An optional product ID associated with the seller (used as mpid). |
| `seller_id` | string | Yes | The unique ID of the seller. |
| `spid` | string | No | An optional seller product ID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tiki-vn-api-714861fa/get_seller_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","seller_id":"<string>","spid":"<string>"}'
```

### search_products

Full-text search over Tiki.vn product listings. Returns paginated results with product summaries including price, rating, seller, and thumbnail. Paginates via page number; each page returns up to `limit` items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of items per page. |
| `page` | integer | No | Page number. |
| `query` | string | Yes | Search keyword. |
| `sort` | string | No | Sort order. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tiki-vn-api-714861fa/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>","sort":"<string>"}'
```