# Tokopedia Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/tokopedia/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/tokopedia-search |

## Description

Extract detailed product data from Tokopedia to boost market insights and optimize your e-commerce strategy.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/tokopedia/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "query": "voiture",
  "results": [
    {
      "url": "https://www.tokopedia.com/auto-store/mobil-mewah-voiture-xyz",
      "image": "https://example.com/image1.jpg",
      "price": "IDR 1.200.000.000",
      "title": "Mobil Mewah Voiture XYZ",
      "rating": 4.5,
      "seller": "Auto Store",
      "location": "Jakarta"
    },
    {
      "url": "https://www.tokopedia.com/family-car-shop/mobil-keluarga-voiture-abc",
      "image": "https://example.com/image2.jpg",
      "price": "IDR 800.000.000",
      "title": "Mobil Keluarga Voiture ABC",
      "rating": 4.7,
      "seller": "Family Car Shop",
      "location": "Bandung"
    },
    {
      "url": "https://www.tokopedia.com/sport-cars/mobil-sport-voiture-def",
      "image": "https://example.com/image3.jpg",
      "price": "IDR 3.000.000.000",
      "title": "Mobil Sport Voiture DEF",
      "rating": 4.9,
      "seller": "Sport Cars",
      "location": "Surabaya"
    }
  ]
}
```

## Documentation

## Overview
Extract detailed product data from Tokopedia to boost market insights and optimize your e-commerce strategy.

## Quickstart
```
GET https://api.piloterr.com/v2/tokopedia/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Tokopedia Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Tokopedia without maintaining scrapers
- Power internal dashboards and workflow automations with live Tokopedia data