# Search Tools — Zapi reference

> Every Search Tools endpoint on Zapi, with parameters, request shape and an example response.

**Base URL:** `https://api-preview.zapi.ink`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a key at https://preview.zapi.ink/dashboard/keys (free tier — 600 req/mo, no credit card).
**Response envelope:** `{ status: "success" | "error", message: string, content: <payload> }`
**Rate limit:** 60 req/min (free tier). Per-endpoint cache TTL is documented below.
**Errors:** standard HTTP codes (`401` invalid key, `429` rate limited, `5xx` upstream). Body always has `{ status: "error", message, errors? }`.

```bash
curl "https://api-preview.zapi.ink/v1/CATEGORY:SCRAPER/ENDPOINT?param=value" \
  -H "x-api-key: $ZAPI_KEY"
```

**Category page:** https://preview.zapi.ink/category/search-tools
**Full catalog:** https://preview.zapi.ink/apis · **Index:** https://preview.zapi.ink/llms-full.txt

---

## Bing Search

**Category:** search-tools · **Slug:** `bing`
**Detail page:** https://preview.zapi.ink/api/search-tools/bing

Bing Search. pencarian web lengkap, snippet, link, multi-bahasa dan region

**Tags:** search, bing, engine

### Search

- **Method:** `GET`
- **Endpoint:** `https://api-preview.zapi.ink/v1/search-tools:bing/search`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Kata kunci pencarian di Bing |
| `language` | string | query | no | Kode bahasa (contoh: en, id, fr) |
| `region` | string | query | no | Kode region negara (contoh: us, id, gb) |

**cURL:**
```bash
curl "https://api-preview.zapi.ink/v1/search-tools:bing/search?query=program%20mbg&language=id&region=id" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api-preview.zapi.ink/v1/search-tools:bing/search?query=program%20mbg&language=id&region=id", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api-preview.zapi.ink/v1/search-tools:bing/search?query=program%20mbg&language=id&region=id",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "query": "program mbg",
  "results": [
    {
      "link": "https://www.bgn.go.id/news/artikel/bgn-akan-memulai-program-mbg-secara-bertahap",
      "title": "BGN akan Memulai Program MBG Secara Bertahap",
      "snippet": "05 Jan 2025 · Program MBG bertujuan meningkatkan status gizi peserta didik, ibu hamil, ibu menyusui, dan anak balita melalui penyediaan makanan bergizi sesuai standar Angka Kecukupan Gizi (AKG) …",
      "position": 1,
      "displayLink": "www.bgn.go.id"
    },
    {
      "link": "https://djpb.kemenkeu.go.id/kppn/raha/id/data-publikasi/artikel/3069-program-makan-bergizi-gratis-mbg-di-indonesia-analisis-kebijakan-dan-perbandingan-dengan-programa-nacional-de-alimenta%C3%A7%C3%A3o-escolar-pnae-di-brasil.html",
      "title": "PROGRAM MAKAN BERGIZI GRATIS (MBG) DI INDONESIA: ANALISIS …",
      "snippet": "01 Apr 2026 · Program Makan Bergizi Gratis (MBG) merupakan kebijakan nasional yang dirancang untuk menyediakan makanan bergizi gratis bagi anak sekolah, balita, dan ibu hamil.",
      "position": 2,
      "displayLink": "djpb.kemenkeu.go.id"
    },
    {
      "link": "https://mbg.pdm.kemendikdasmen.go.id/portal",
      "title": "Dashboard MBG",
      "snippet": "1 day ago · Rekap Data Program Makan Bergizi Gratis 2026-05-21 11:50:39 SATUAN PENDIDIKAN 22.138 NEGERI 12.282 SWASTA 9.856",
      "position": 3,
      "displayLink": "mbg.pdm.kemendikdasmen.go.id"
    },
    {
      "link": "https://id.wikipedia.org/wiki/Makan_Bergizi_Gratis",
      "title": "Makan Bergizi Gratis - Wikipedia bahasa Indonesia, ensiklopedia bebas",
      "snippet": "Sejarah Pemerintah meluncurkan program Makan Bergizi Gratis (MBG) dengan tujuan meningkatkan gizi masyarakat dan mengurangi angka kemiskinan. Program MBG menargetkan 82,9 juta penerima …",
      "position": 4,
      "displayLink": "id.wikipedia.org"
    },
    {
      "link": "https://www.relic.id/apa-itu-mbg-program-makan-bergizi-gratis-dari-pemerintah/",
      "title": "Apa Itu MBG? Program Makan Bergizi Gratis dari Pemerintah",
      "snippet": "21 Des 2025 · RELIC.ID – Program Makan Bergizi Gratis (MBG) kini menjadi salah satu topik paling hangat dalam perbincangan nasional di Indonesia. Sebagai inisiatif unggulan pemerintah di bawah …",
      "position": 5,
      "displayLink": "www.relic.id"
    },
    {
      "link": "https://stunting.go.id/peraturan-presiden-nomor-83-tahun-2024-tentang-badan-gizi-nasional-landasan-program-makan-bergizi-gratis/",
      "title": "Peraturan Presiden Nomor 83 Tahun 2024 tentang Badan Gizi Nasional ...",
      "snippet": "30 Jan 2026 · Ringkasan Peraturan Presiden Nomor 83 Tahun 2024 menetapkan pembentukan Badan Gizi Nasional (BGN) sebagai lembaga yang bertanggung jawab dalam perumusan dan pelaksanaan …",
      "position": 6,
      "displayLink": "stunting.go.id"
    },
    {
      "link": "https://s.id/Program-MBG-Kemendikdasmen",
      "title": "Program Makan Bergizi Gratis - s.id",
      "snippet": "Instrumen Pendataan dan Pengukuran Penerima Dampak Program MBG.",
      "position": 7,
      "displayLink": "s.id"
    }
  ],
  "totalResults": 110000,
  "relatedSearches": []
}
```

---

## Yahoo Search

**Category:** search-tools · **Slug:** `yahoo`
**Detail page:** https://preview.zapi.ink/api/search-tools/yahoo

Yahoo Search scraper — hasil pencarian, snippet, related searches.

**Tags:** search, yahoo, web

### Endpoint 2

- **Method:** `GET`
- **Endpoint:** `https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-2/:id`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Search keyword |

**cURL:**
```bash
curl "https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-2/:id?query=VALUE" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-2/:id?query=VALUE", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-2/:id?query=VALUE",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "query": "tiktok.com/@mraloy/video/7637743127637331207"
}
```

---

### Search

- **Method:** `GET`
- **Endpoint:** `https://api-preview.zapi.ink/v1/search-tools:yahoo/search`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Kata kunci pencarian |
| `count` | number | query | no | Jumlah hasil. Default 10, maks 50 |
| `start` | number | query | no | Offset hasil pertama (untuk paginasi). Default 1 |

**cURL:**
```bash
curl "https://api-preview.zapi.ink/v1/search-tools:yahoo/search?query=ihsg&count=1&start=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api-preview.zapi.ink/v1/search-tools:yahoo/search?query=ihsg&count=1&start=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api-preview.zapi.ink/v1/search-tools:yahoo/search?query=ihsg&count=1&start=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 3,
  "query": "ihsg",
  "results": [
    {
      "link": "https://www.idx.id/en/products/index/",
      "title": "Index [www.idx.id]",
      "snippet": "22 hours ago · Stock Index The Indonesia Stock Exchange (IDX) actively continues to innovate in the development through providing stock indices that can be used by all participants in Indonesia capital market. The index book \"IDX Stock Index Handbook\" contains a concise overview of the indices provided by the IDX.",
      "position": 1,
      "displayLink": "www.idx.id"
    },
    {
      "link": "https://en.wikipedia.org/wiki/IDX_Composite",
      "title": "IDX Composite - Wikipedia",
      "snippet": "'Combined Stock Prices Index', IHSG) is a stock index of all stocks listed on the Indonesia Stock Exchange, IDX (formerly known as Jakarta Stock Exchange, JSX).",
      "position": 2,
      "displayLink": "en.wikipedia.org"
    },
    {
      "link": "https://www.idxchannel.com/stocks?index=IHSG&indexdetail=mainidxindices",
      "title": "IDX Channel - Real Time Data Market & Chart Saham IHSG",
      "snippet": "Real-time Data Market, Chart, Data Historis, Analisis Dan Berita Saham Terkini Hari Ini | Market Stock - IDX Channel IHSG",
      "position": 3,
      "displayLink": "www.idxchannel.com"
    }
  ],
  "relatedSearches": []
}
```

---

### Endpoint 4

- **Method:** `GET`
- **Endpoint:** `https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-4`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Search keyword |

**cURL:**
```bash
curl "https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-4?query=VALUE" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-4?query=VALUE", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-4?query=VALUE",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

---

### Endpoint 3

- **Method:** `GET`
- **Endpoint:** `https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-3`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Search keyword |

**cURL:**
```bash
curl "https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-3?query=VALUE" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-3?query=VALUE", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-3?query=VALUE",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

---

### Endpoint 5

- **Method:** `GET`
- **Endpoint:** `https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-5`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Search keyword |

**cURL:**
```bash
curl "https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-5?query=VALUE" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-5?query=VALUE", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api-preview.zapi.ink/v1/search-tools:yahoo/endpoint-5?query=VALUE",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

---