# Tokopedia



Public product data from the Tokopedia marketplace — search the catalog by keyword, then read any listing in full: price, stock, order limits, description, and the shop behind it.



## Tokopedia Product Search

Search Tokopedia's public catalog — name, price, discount, rating, shop, and category on every card, sixty cards a page.

- Method: `GET`
- Path: `/v1/marketplace/tokopedia/search`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `q` | string | required | What to search the catalog for. |
| `page` | integer | optional | Result page, sixty cards each. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/marketplace/tokopedia/search \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "query": "iphone 15",
    "page": 1,
    "total_count": 266736,
    "items": [
      {
        "product_id": "12628743036",
        "shop_slug": "supcaseofficial",
        "product_slug": "case-iphone-15-pro-max-youngkit-rock-frosted-foldable-magnetic-ring-black-iphone-15-pro-892c2",
        "name": "Case iPhone 15 Pro Max YOUNGKIT Rock Frosted Foldable Magnetic Ring",
        "price": 370260,
        "price_display": "Rp370.260",
        "original_price_display": "Rp425.000",
        "discount_percentage": 13,
        "rating": 5.0,
        "rating_count": 0,
        "shop_name": "Supcase Official ID",
        "shop_city": "Jakarta Barat",
        "shop_official": true,
        "category": "Hard Case Handphone",
        "image": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/1f9ad5a43c03431e9b9f76f47060c7f1~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg",
        "url": "https://www.tokopedia.com/supcaseofficial/case-iphone-15-pro-max-youngkit-rock-frosted-foldable-magnetic-ring-black-iphone-15-pro-892c2"
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T14:45:00.000Z",
    "age_seconds": 120,
    "next_update_at": "2026-08-20T14:50:00.000Z"
  }
}
```

## Tokopedia Product Detail

One Tokopedia listing in full — price, discount, stock, order limits, weight, the listing's own description, rating, and the shop behind it.

- Method: `GET`
- Path: `/v1/marketplace/tokopedia/products/{shop}/{product}`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `shop` | path segment | required | The shop slug from a search card — the first segment of its `url`. |
| `product` | path segment | required | The listing slug from a search card — the second segment of its `url`. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/marketplace/tokopedia/products/%7Bshop%7D/%7Bproduct%7D \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "product_id": "12067120510",
    "shop_slug": "proxindonesia",
    "product_slug": "prox-tempered-glass-for-iphone-15-pro-max-full-cover-clear-1731635582542906715",
    "name": "PROX Tempered Glass For iPhone 15 Pro Max Full Cover Clear",
    "price": 65000,
    "price_display": "Rp65.000",
    "original_price_display": "Rp69.000",
    "discount_percentage": 6,
    "stock": 2718,
    "min_order": 1,
    "max_order": 2718,
    "condition": "NEW",
    "weight_kg": 0.05,
    "description": "PROX Premium Tempered Glass Clear",
    "rating": 5,
    "rating_count": 12,
    "category": "Screen Protector Handphone",
    "image": "https://images.tokopedia.net/img/cache/500-square/VqbcmM/2023/11/9/b85e226d-3d48-4fd4-9acb-d4bc1d29e14a.png",
    "url": "https://www.tokopedia.com/proxindonesia/prox-tempered-glass-for-iphone-15-pro-max-full-cover-clear-1731635582542906715",
    "status": "ACTIVE"
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T14:45:00.000Z",
    "age_seconds": 60,
    "next_update_at": "2026-08-20T14:50:00.000Z"
  }
}
```