Dokumentasi Referensi API Referensi SDK Penggunaan Agentik Skill AI

Pencarian Web

Memetakan URL situs web

Jelajahi grafik tautan situs dari URL akar dan kembalikan URL yang ditemukan. Ini endpoint khusus discovery tanpa field ekstraksi konten. Gunakan Bearer API key atau api_key di JSON body sebagai fallback kompatibilitas; kedua base URL didukung. Field yang tidak dikenal diabaikan. Respons berisi base_url, array URL results, response_time, usage.credits dan usage.cost tambahan berdasarkan harga per credit yang ditetapkan admin, serta request_id. Pemetaan berbiaya 1 kredit per 10 halaman berhasil, atau 2 kredit jika instructions diberikan; halaman gagal gratis. Kredit aktual diambil dari kuota gratis harian bersama. Jika estimasi dari limit melebihi sisa kuota, kelebihannya ditagihkan ke saldo, atau dikembalikan 432 tanpa saldo dengan saran menurunkan limit. Contoh SDK; simpan kunci di variabel lingkungan atau konfigurasi sisi server yang aman. Python: from tavily import TavilyClient client = TavilyClient(api_key="...", api_base_url="https://api.bazaarlink.ai/v1") response = client.map("docs.tavily.com") JavaScript: import { tavily } from "@tavily/core" const tvly = tavily({ apiKey: process.env.BAZAARLINK_API_KEY, apiBaseURL: "https://api.bazaarlink.ai/v1" }) const response = await tvly.map("docs.tavily.com")

POST/v1/map

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Body

urlwajib

string

URL akar untuk pemetaan; scheme boleh dihilangkan, misalnya docs.tavily.com.

required; scheme optional

Example: "docs.tavily.com"

instructions

string

Instruksi discovery dalam bahasa alami; biaya mapping menjadi 2 credit, bukan 1, per 10 halaman berhasil.

Example: "Find Python SDK pages"

max_depth

integer

Kedalaman pemetaan maksimum, 1–5, default 1.

1-5; default: 1

Example: 1

max_breadth

integer

Jumlah maksimum tautan yang diikuti per halaman di setiap tingkat, 1–500, default 20.

1-500; default: 20

Example: 20

limit

integer

Total tautan yang diproses sebelum berhenti; minimum 1, default 50.

minimum: 1; default: 50

Example: 50

select_paths

string[]

Array pola regex untuk pemilihan jalur; maksimal 50 entri, setiap pola dibatasi 200 karakter.

max 50 entries; max 200 characters per regex

Example: ["^/docs/.*"]

select_domains

string[]

Array pola regex untuk pemilihan domain; maksimal 50 entri, setiap pola dibatasi 200 karakter.

max 50 entries; max 200 characters per regex

Example: ["^docs\.example\.com$"]

exclude_paths

string[]

Array pola regex untuk pengecualian jalur; maksimal 50 entri, setiap pola dibatasi 200 karakter.

max 50 entries; max 200 characters per regex

Example: ["^/private/.*"]

exclude_domains

string[]

Array pola regex untuk pengecualian domain; maksimal 50 entri, setiap pola dibatasi 200 karakter.

max 50 entries; max 200 characters per regex

Example: ["^private\.example\.com$"]

allow_external

boolean

Apakah tautan domain eksternal dimasukkan ke hasil akhir, default true.

default: true

Example: true

timeout

number

Detik untuk menunggu pemetaan. Rentang Tavily 10–150, tetapi batas efektif BazaarLink 90 detik; nilai di atas 90 diturunkan menjadi 90.

Tavily: 10-150; BazaarLink default/effective maximum: 90 seconds; values above 90 are lowered to 90

Example: 90

include_usage

boolean

Apakah usage disertakan dalam respons, default false; jika disertakan akan memuat credits dan usage.cost.

default: false

Example: false

POST /v1/map

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/v1/map   -H "Authorization: Bearer $BAZAARLINK_API_KEY"   -H "Content-Type: application/json"   -d '{
    "url": "docs.tavily.com",
    "instructions": "Find Python SDK pages",
    "limit": 20,
    "timeout": 90,
    "include_usage": true
  }'

Contoh respons

Pemetaan selesai. results berisi string URL yang ditemukan; setiap 10 halaman berhasil berbiaya 1 kredit, atau 2 kredit jika instructions diberikan.

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "base_url": "docs.tavily.com",
  "results": [
    "https://docs.tavily.com/welcome",
    "https://docs.tavily.com/documentation/api-credits"
  ],
  "response_time": 1.23,
  "usage": {
    "credits": 1,
    "cost": 0.01
  },
  "request_id": "map_123e4567-e89b-12d3-a456-426614174111"
}