# Coupang — 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 Coupang products by price and ratings, read detailed customer reviews with summaries, and discover recommended items based on products you're interested in. Get paginated review data to compare options and make informed shopping decisions.

**Category:** E-commerce | **Website:** [www.coupang.com/np/search?component=&q=](https://www.coupang.com/np/search?component=&q=) | **Docs:** [parse.bot/marketplace/ba33783a-7430-49a1-bdef-662d1f8f8d17/coupang-com-api](https://parse.bot/marketplace/ba33783a-7430-49a1-bdef-662d1f8f8d17/coupang-com-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-coupang-com-api-ba33783a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_recommendations

Get recommended products based on one or more Coupang product IDs. Returns related products that other shoppers viewed, with full pricing in KRW, ratings, discount rates, delivery options, and social proof indicators. The recommendation algorithm is collaborative filtering ("people who viewed X also viewed Y"). Products are returned up to max_count; fewer may be returned if insufficient recommendations exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_count` | integer | No | Maximum number of products to return (5-15). |
| `product_ids` | string | No | Comma-separated Coupang product IDs to get recommendations for. Each ID is a numeric string (e.g. '8499380264' or '8499380264,7991194687'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coupang-com-api-ba33783a/get_product_recommendations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_count":"<integer>","product_ids":"<string>"}'
```

### get_product_reviews

Get paginated reviews for a specific Coupang product, including rating summary with distribution and individual review details with survey answers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `product_id` | string | Yes | Coupang product ID. |
| `size` | integer | No | Number of reviews per page. |
| `sort_by` | string | No | Sort order: ORDER_SCORE_ASC, ORDER_SCORE_DESC, DATE_DESC. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coupang-com-api-ba33783a/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","product_id":"<string>","size":"<integer>","sort_by":"<string>"}'
```