웹 검색 — BazaarLink API

웹 검색

Tavily 호환 `POST /v1/search`는 언어 모델을 호출하지 않고 순위가 매겨진 결과를 반환합니다. `Authorization: Bearer <BazaarLink key>` 또는 JSON body의 `api_key`로 인증합니다. `https://api.bazaarlink.ai/v1` 또는 완전히 지원되는 `https://bazaarlink.ai/api/v1`을 사용하세요. frozen OpenAPI의 모든 필드는 검증되며 알 수 없는 필드는 무시됩니다. 검색 깊이, 날짜, 언어, 도메인, 이미지, 답변 및 raw content 옵션은 아래 계약을 따릅니다. 무료 할당량은 이메일 인증이 필요하고 매일 00:00 UTC에 재설정됩니다. 잔액이 없는 계정과 잔액이 있는 계정의 할당량은 다르며 현재 N/M 값은 데이터베이스의 `getPublicFreeSearchAllowance()`에서 옵니다. 현재 일일 할당량은 pricing page에서 확인하세요. 무료 할당량을 소진하고 잔액도 없으면 432를 반환합니다. 고객 가격은 credit 수에 admin이 설정한 credit당 가격을 곱한 값입니다. 달러 가격을 하드코딩하지 않으며 pricing page와 각 응답의 `usage.cost`를 확인하세요. Python은 `TavilyClient(api_key=..., api_base_url='https://api.bazaarlink.ai/v1')`, JS는 `tavily({ apiKey, apiBaseURL })`, LangChain은 `TavilySearch(api_base_url=...)`를 사용합니다.

POST/v1/search

인증

Authorization필수

string · header

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

Body

query필수

string

실행할 검색 쿼리입니다.

required; non-empty search query

Example: who is Leo Messi?

search_depth

string

지연 시간, 관련성 및 결과 콘텐츠 생성을 제어합니다. 기본값은 `basic`이며 `basic`, `fast`, `ultra-fast`는 각각 1 credit, `advanced`는 2 credits입니다.

default: basic

advancedbasicfastultra-fast

chunks_per_source

integer

소스당 관련 콘텐츠 조각의 최대 개수입니다. 기본값은 3, 허용 범위는 1–3이며 `advanced`, `basic`, `fast`에서 사용할 수 있습니다.

default: 3; 1..3

max_results

integer

반환할 검색 결과의 최대 개수입니다. 기본값은 10, 허용 범위는 0–20입니다.

default: 10; 0..20

Example: 1

topic

string

검색 주제입니다. 기본값은 `general`이며 최신 뉴스에는 `news`, 금융 콘텐츠에는 `finance`를 사용합니다.

default: general

generalnewsfinance

time_range

string

게시 또는 업데이트 날짜로 필터링합니다. 기본값은 설정되지 않으며 `day`, `week`, `month`, `year`, `d`, `w`, `m`, `y`를 사용할 수 있습니다.

default: null

dayweekmonthyeardwmy

start_date

string

이 날짜 이후 게시 또는 업데이트된 결과를 반환합니다. 형식: YYYY-MM-DD.

default: null; format YYYY-MM-DD

Example: 2025-02-09

end_date

string

이 날짜 이전에 게시 또는 업데이트된 결과를 반환합니다. 형식: YYYY-MM-DD.

default: null; format YYYY-MM-DD

Example: 2025-12-29

include_published_date

boolean

각 결과에 예상 게시 또는 업데이트 날짜를 포함합니다. `news` 주제에서는 자동으로 활성화되며 기본값은 `false`입니다.

default: false

filter_by_published_date

boolean

`time_range`, `start_date`, `end_date` 범위를 벗어나거나 날짜를 감지할 수 없는 결과를 제거합니다. 기본값은 `false`이며 `true`이면 `include_published_date`도 활성화됩니다.

default: false

include_answer

boolean | string

LLM이 생성한 답변을 포함합니다. 기본값은 `false`이며 boolean 또는 `basic`/`advanced`를 받습니다.

default: false

basicadvanced

include_raw_content

boolean | string

각 결과의 정제된 HTML 콘텐츠를 포함합니다. 기본값은 `false`이며 boolean 또는 `markdown`/`text`를 받습니다.

default: false

markdowntext

include_images

boolean

최상위에 쿼리 관련 이미지를, 각 결과 안에 소스 이미지를 포함합니다. 기본값은 `false`입니다.

default: false

include_image_descriptions

boolean

`include_images`가 `true`이면 각 이미지에 설명을 추가합니다. 기본값은 `false`입니다.

default: false

include_favicon

boolean

각 결과에 favicon URL을 포함할지 여부입니다. 기본값은 `false`입니다.

default: false

include_domains

string[]

나열된 도메인으로 결과를 제한하며 최대 300개 도메인입니다. 기본값은 빈 배열입니다.

default: []; maximum 300 items

exclude_domains

string[]

나열된 도메인의 결과를 제외하며 최대 150개 도메인입니다. 기본값은 빈 배열입니다.

default: []; maximum 150 items

include_domains_mode

string

`include_domains` 적용 방식을 제어합니다. `restrict`는 해당 도메인만 허용하고 `prefer`는 우선하지만 다른 도메인도 반환할 수 있습니다. `include_domains`가 필요하며 없으면 400을 반환합니다. 기본값은 설정되지 않습니다.

default: null; requires include_domains

restrictprefer

country

string

선택한 국가의 결과를 우선합니다. `topic`이 `general`일 때만 사용할 수 있으며 기본값은 설정되지 않습니다.

default: null; only when topic is general

afghanistanalbaniaalgeriaandorraangolaargentinaarmeniaaustraliaaustriaazerbaijanbahamasbahrainbangladeshbarbadosbelarusbelgiumbelizebeninbhutanboliviabosnia and herzegovinabotswanabrazilbruneibulgariaburkina fasoburundicambodiacamerooncanadacape verdecentral african republicchadchilechinacolombiacomoroscongocosta ricacroatiacubacyprusczech republicdenmarkdjiboutidominican republicecuadoregyptel salvadorequatorial guineaeritreaestoniaethiopiafijifinlandfrancegabongambiageorgiagermanyghanagreeceguatemalaguineahaitihondurashungaryicelandindiaindonesiairaniraqirelandisraelitalyjamaicajapanjordankazakhstankenyakuwaitkyrgyzstanlatvialebanonlesotholiberialibyaliechtensteinlithuanialuxembourgmadagascarmalawimalaysiamaldivesmalimaltamauritaniamauritiusmexicomoldovamonacomongoliamontenegromoroccomozambiquemyanmarnamibianepalnetherlandsnew zealandnicaraguanigernigerianorth koreanorth macedonianorwayomanpakistanpanamapapua new guineaparaguayperuphilippinespolandportugalqatarromaniarussiarwandasaudi arabiasenegalserbiasingaporeslovakiasloveniasomaliasouth africasouth koreasouth sudanspainsri lankasudanswedenswitzerlandsyriataiwantajikistantanzaniathailandtogotrinidad and tobagotunisiaturkeyturkmenistanugandaukraineunited arab emiratesunited kingdomunited statesuruguayuzbekistanvenezuelavietnamyemenzambiazimbabwe

language

string

선택한 언어의 결과를 우선합니다. ISO 639-1 코드 또는 영어 언어 이름을 허용하며 기본값은 설정되지 않습니다.

default: null

Example: en

filter_by_language

boolean

`language`와 일치하지 않는 결과를 엄격히 제거합니다. `language`가 필요하며 없으면 400을 반환합니다. 기본값은 `false`입니다.

default: false; requires language

auto_parameters

boolean

쿼리 의도에 따라 검색 매개변수를 자동 선택합니다. 명시적 값이 우선하며 `include_answer`, `include_raw_content`, `max_results`는 수동 설정해야 합니다. 요청마다 2 credits가 추가됩니다. 기본값은 `false`입니다.

default: false; costs 2 credits

exact_match

boolean

쿼리의 인용된 구문을 포함하는 결과만 반환하여 동의어와 의미적 변형을 피합니다. 기본값은 `false`입니다.

default: false

include_usage

boolean

응답에 credit 사용량을 포함할지 여부입니다. 기본값은 `false`입니다.

default: false

safe_search

boolean

성인 또는 안전하지 않은 콘텐츠를 필터링합니다. 기본값은 `false`이며 `fast`, `ultra-fast`에서는 지원되지 않습니다.

default: false; unsupported for fast and ultra-fast

api_key

string

선택적 JSON body 인증 필드입니다. Bearer header가 없을 때 BazaarLink API key를 여기에 넣을 수 있으며 검증 및 전달 전에 제거됩니다.

days

integer

SDK 호환 필드 `days`입니다. 호환성을 위해 허용되며 계획에 따라 호환 계층에서 전달하거나 무시할 수 있고 frozen OpenAPI schema의 일부가 아닙니다.

max_hours

integer

SDK 호환 필드 `max_hours`입니다. 호환성을 위해 허용되며 계획에 따라 호환 계층에서 전달하거나 무시할 수 있고 frozen OpenAPI schema의 일부가 아닙니다.

fetch_timeout

number

SDK 호환 필드 `fetch_timeout`입니다. 호환성을 위해 허용되며 계획에 따라 호환 계층에서 전달하거나 무시할 수 있고 frozen OpenAPI schema의 일부가 아닙니다.

cache_fallback

boolean

SDK 호환 필드 `cache_fallback`입니다. 호환성을 위해 허용되며 계획에 따라 호환 계층에서 전달하거나 무시할 수 있고 frozen OpenAPI schema의 일부가 아닙니다.

timeout

number

SDK 호환 `timeout` 필드입니다. 호환성을 위해 허용하며 검색은 서비스 측 timeout을 사용하고 알 수 없거나 지원되지 않는 필드는 무시합니다.

POST /v1/search

1
2
3
4
5
6
7
8
9
10
curl https://api.bazaarlink.ai/v1/search \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest news on open-source language models",
    "search_depth": "basic",
    "max_results": 5,
    "topic": "news",
    "time_range": "week"
  }'

응답 예시

성공 응답에는 `query`, 선택적 `answer`, 최상위 `images`, `title`, `url`, `content`, `score` 및 선택적 `raw_content`, `published_date`, `favicon`, `images`, `id`를 포함하는 `results`, 선택적 `auto_parameters`, `response_time`, `credits`와 추가 `cost`가 있는 `usage`, `request_id`가 포함됩니다. `usage.cost`는 고객에게 청구되는 USD 가격이며 COGS가 아닙니다. `request_id`는 BazaarLink가 생성합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
  "query": "Who is Leo Messi?",
  "answer": "Lionel Messi is an Argentine footballer.",
  "images": [
    {
      "url": "https://example.com/messi.jpg",
      "description": "Lionel Messi"
    }
  ],
  "results": [
    {
      "title": "Lionel Messi Facts | Britannica",
      "url": "https://www.britannica.com/facts/Lionel-Messi",
      "content": "Lionel Messi is an Argentine footballer.",
      "score": 0.81025416,
      "raw_content": null,
      "published_date": "Tue, 11 Mar 2025 17:00:00 GMT",
      "favicon": "https://britannica.com/favicon.png",
      "images": [
        {
          "url": "https://example.com/messi.jpg",
          "description": "Lionel Messi"
        }
      ],
      "id": "a3f9c2-04"
    }
  ],
  "auto_parameters": {
    "topic": "general",
    "search_depth": "basic"
  },
  "response_time": 1.67,
  "usage": {
    "credits": 1,
    "cost": "<customer_price_usd>"
  },
  "request_id": "123e4567-e89b-12d3-a456-426614174111"
}