웹 검색

웹사이트 URL 매핑

루트 URL에서 웹사이트 링크 그래프를 탐색하고 발견한 URL을 반환합니다. 콘텐츠 추출 필드가 없는 discovery 전용 엔드포인트입니다. Bearer API 키 또는 호환성을 위한 JSON body의 api_key를 사용할 수 있고 두 base URL을 모두 지원합니다. 알 수 없는 필드는 무시됩니다. 응답에는 base_url, URL 문자열 results 배열, response_time, 관리자가 설정한 credit 단가를 적용한 추가 usage.credits와 usage.cost, request_id가 포함됩니다. 매핑은 성공 페이지 10개당 1 credit이며 instructions를 지정하면 2 credit입니다. 실패한 페이지는 무료입니다. 실제 credit은 공유 일일 무료 한도에서 차감됩니다. limit 예상치가 잔여 한도를 넘으면 초과분은 잔액에서 청구하고, 잔액이 없으면 432를 반환하며 limit을 낮추도록 안내합니다. SDK 예시입니다. 키는 환경 변수나 안전한 서버 측 설정에 보관하세요. 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

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

Body

url필수

string

매핑을 시작할 루트 URL입니다. scheme은 생략할 수 있으며 예: docs.tavily.com.

required; scheme optional

Example: "docs.tavily.com"

instructions

string

탐색에 대한 자연어 지시입니다. 지정하면 성공 페이지 10개당 mapping 비용이 1이 아니라 2 credit이 됩니다.

Example: "Find Python SDK pages"

max_depth

integer

최대 매핑 깊이로 1~5, 기본값은 1입니다.

1-5; default: 1

Example: 1

max_breadth

integer

각 단계에서 페이지당 따라갈 최대 링크 수로 1~500, 기본값 20입니다.

1-500; default: 20

Example: 20

limit

integer

중지하기 전에 처리할 총 링크 수로 최소 1, 기본값 50입니다.

minimum: 1; default: 50

Example: 50

select_paths

string[]

경로 선택에 사용할 정규식 배열입니다. 최대 50개이며 각 패턴은 200자까지입니다.

max 50 entries; max 200 characters per regex

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

select_domains

string[]

도메인 선택에 사용할 정규식 배열입니다. 최대 50개이며 각 패턴은 200자까지입니다.

max 50 entries; max 200 characters per regex

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

exclude_paths

string[]

경로 제외에 사용할 정규식 배열입니다. 최대 50개이며 각 패턴은 200자까지입니다.

max 50 entries; max 200 characters per regex

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

exclude_domains

string[]

도메인 제외에 사용할 정규식 배열입니다. 최대 50개이며 각 패턴은 200자까지입니다.

max 50 entries; max 200 characters per regex

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

allow_external

boolean

외부 도메인 링크를 최종 결과에 포함할지 여부이며 기본값은 true입니다.

default: true

Example: true

timeout

number

매핑을 기다릴 시간(초)입니다. Tavily 범위는 10~150이지만 BazaarLink 유효 최대값은 90초이며 90 초과 값은 90으로 낮춥니다.

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

Example: 90

include_usage

boolean

응답에 usage를 포함할지 여부이며 기본값은 false입니다. 포함하면 credits와 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
  }'

응답 예시

매핑이 완료되었습니다. results에는 발견된 URL 문자열이 포함되며 성공 페이지 10개당 기본 1 credit, instructions 지정 시 2 credit입니다.

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"
}