---
title: "Search Tokopedia products"
method: GET
path: "/tokopedia/search"
tags: ["Tokopedia"]
---

# Search Tokopedia products

`GET /tokopedia/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tokopedia/search`
- Auth: API key in header `x-api-key`

Returns public Tokopedia product cards for a keyword from Tokopedia's public product-search operation. `sort` accepts `3` (lowest price), `4` (highest price), `5` (most reviewed), `9` (newest), or `23` (most relevant). Repeat `filter` as `key:value` using values from `/tokopedia/search/filters`.

## Query parameters

- `q` string, required
- `page` integer
- `sort` 3 | 4 | 5 | 9 | 23
- `filter` string[]

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TokopediaSearchResponseDoc
  - `code` integer
  - `data` TokopediaSearchResponse
    - `browser_rendered` boolean
    - `fetched_at` string
    - `page` integer
    - `products` TokopediaProduct[]
      - `image_url` string
      - `name` string
      - `price` integer
      - `price_text` string
      - `rating` string
      - `shop_city` string
      - `shop_name` string
      - `url` string
    - `query` string
    - `sort` integer
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)