본문으로 건너뛰기
체인지로그새 기능

Search를 소개해요

Search
POST /v1/search로 보낸 '추운 지역에서 히트펌프가 작동하는 방식' 검색: 사이트 로고와 점수가 붙은 페이지 3개, 답이 되는 부분을 강조한 첫 페이지 단락, FRAMES 정답률 Pro Search 68.5%와 Search 66.5%

에이전트에 웹 검색을 한 번의 호출로 붙여요. 결과마다 검색어에 답하는 페이지 단락이 함께 오고, 검색 한 번에 0.5크레딧이에요.

받는 결과

  • results: 검색어에 맞는 페이지를 점수 순으로 최대 10개 받습니다. 결과마다 url, title, snippet, 0~1 사이의 관련도 score가 있습니다.
  • text: 페이지마다 검색어에 답하는 단락입니다. 결과 하나에 최대 10,000자이고, 모델에 그대로 넘길 수 있습니다.
  • 페이지가 밝히면 publishedDate, siteName도 받습니다.
  • querying.ai MCP 서버의 web_search 도구로도 같은 가격에 씁니다. Claude Code, Codex, Cursor 같은 MCP 클라이언트에서 씁니다.

동작 방식

POST /v1/search에 검색어를 보내면 결과가 같은 응답으로 돌아올 때까지 요청이 열려 있습니다. 에이전트는 요청 한 번으로 맥락을 얻고, 페이지를 따로 가져오는 두 번째 호출이 필요 없습니다.

type으로 검색 방식을 고릅니다. 기본값은 standard입니다. pro는 웹을 더 넓게 찾고 여러 출처가 필요한 질문에 맞는 단락을 더 꼼꼼히 골라, 약 4초에 답합니다. 두 방식 모두 site:, -site:, after:, before: 연산자로 범위를 좁힙니다. 30초가 지나도 끝나지 않은 검색은 태스크로 돌아오고, 결과는 GET /v1/async/task/{id}로 읽습니다.

2026년 11월 15일 FRAMES 질문 200개로 잰 결과, 모델이 Search 결과만 보고 답했을 때 66.5%, Pro Search 결과로 답했을 때 68.5%가 정답이었습니다. 측정 방법과 전체 비교는 Search 페이지에 있습니다: https://querying.ai/agent-search

FRAMES 정답률과 검색 1,000번 가격: querying.ai Search 66.5%에 $0.50, Pro Search 68.5%에 $2.00, Parallel fast 63.5%에 $1.00, Parallel advanced 70.0%에 $5.00, Exa 68.0%에 $7.00, Tavily basic 48.5%에 $5.00, Tavily advanced 53.5%에 $10.00, Firecrawl 43.5%에 $1.20
기업 뉴스 질문 100개에서 정답 1,000개를 얻는 비용: querying.ai Search $0.51, Parallel fast $1.00, Firecrawl $1.26, querying.ai Pro Search $2.02, Parallel advanced $5.00, Tavily basic $5.10, Exa $7.07, Tavily advanced $10.20

이렇게 활용하세요

  • 코딩 에이전트나 리서치 에이전트에 페이지 본문까지 담긴 웹 검색을 도구 호출 한 번으로 줍니다.
  • 챗봇 답변을 최신 페이지에 근거해 쓰고, 단락마다 url을 출처로 보여 줍니다.
  • includeDomains로 믿을 만한 사이트 안에서만, after:로 최근 페이지에서만 찾습니다.

요청 보내기

API 키를 Authorization 헤더에 넣어 요청을 보냅니다.

curl -X POST https://api.querying.ai/v1/search \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how do heat pumps work in cold climates",
    "type": "pro",
    "numResults": 3,
    "contents": { "text": { "maxCharacters": 500 } }
  }'

요청 필드

querystring필수
검색어입니다. 최대 400자. site:example.com, -site:example.com, after:YYYY-MM-DD, before:YYYY-MM-DD 연산자를 씁니다.
typestring
standard 또는 pro입니다. pro는 여러 출처가 필요한 질문을 더 깊게 찾습니다. 기본값 standard.
numResultsinteger
돌려받을 결과 수입니다. 1~10, 기본값 5.
contents.text.maxCharactersinteger
결과마다 text에 담을 페이지 글자 수입니다. 200~10,000, 기본값 2,000.
userLocationstring
한 시장의 결과가 필요할 때 넣는 두 글자 국가 코드입니다. 비워 두면 검색어의 언어로 가장 빠르게 찾습니다.
includeDomainsarray
호스트 이름 최대 20개입니다. 이 사이트와 하위 도메인의 결과만 받습니다.
excludeDomainsarray
결과에서 뺄 호스트 이름 최대 20개입니다.
idempotencyKeystring
요청에 붙이는 고유 ID입니다. 키 하나는 계정에서 태스크 하나를 만들므로, 다시 보내도 태스크는 하나로 유지됩니다.

응답

응답입니다. 길이를 줄여 보여 드립니다.

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SEARCH",
    "status": "COMPLETED",
    "createdAt": "…",
    "latencyMs": 4063
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "query": "how do heat pumps work in cold climates",
    "source": "all",
    "type": "pro",
    "results": [
      {
        "url": "https://www.carrier.com/us/en/residential/hvac-resources/heat-pumps/cold-climate-heat-pump/",
        "title": "Cold Climate Heat Pump Systems | Efficient Heating in Extreme …",
        "snippet": "In the winter, heat pumps work in cold weather by extracting thermal energy from the outdoor air and transferring it …",
        "text": "## Do cold climate heat pumps work?\n\nA heat pump is a versatile, year-round system that heats and cools your home by moving heat energy rather than generating it. In the winter, heat pumps work in cold weather by extracting thermal energy from the outdoor air and transferring it indoors.\n\n…",
        "score": 1,
        "publishedDate": "2026-09-15T11:03:00.000Z"
      },
      {
        "url": "https://www.mitsubishicomfort.com/articles/mythbusters-heat-pumps-for-extreme-cold-climates",
        "title": "Heat Pumps in Extreme Cold Climates | Mitsubishi Electric HVAC US",
        "snippet": "In cold climates, heat pumps typically experience a decrease in pressure, refrigerant flow rate and operational …",
        "text": "## Myth: Heat Pumps Are Only for Mild and Warm Climates\n\nHow do they work? In cold climates, heat pumps typically experience a decrease in pressure, refrigerant flow rate and operational capacity. …",
        "score": 0.8333,
        "publishedDate": "2026-10-19T12:06:06.108Z"
      },
      {
        "url": "https://homes.rewiringamerica.org/articles/heating-and-cooling/heat-pumps-cold-weather",
        "title": "Do heat pumps work in cold climates? - Rewiring America",
        "snippet": "…",
        "text": "In heating mode, heat pumps go into reverse and pump heat from the air outside your home to the inside. …",
        "score": 0.6667
      }
    ]
  }
}
task.statusstring
QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.
credits.creditsChargedinteger
끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.
response.resultsarray
점수 순으로 정렬한 페이지입니다. 결과마다 url, title, snippet, text, score가 있고, 페이지가 밝히면 publishedDate, siteName도 붙습니다.
response.results[].textstring
페이지에서 검색어에 답하는 단락입니다. 페이지 순서대로, 제목은 # 줄, 목록은 - 줄로 담깁니다.
response.results[].scorenumber
0~1 사이의 관련도입니다. 같은 응답 안에서 비교합니다.

요금

크레딧은 검색이 완료될 때 차감됩니다. standard 검색은 0.5크레딧, pro 검색은 2크레딧입니다. Max 플랜에서는 standard 검색 1,000번이 $0.50입니다. 새 계정은 무료 500크레딧으로 시작하며, standard 검색 1,000번에 해당합니다. 플랜은 https://querying.ai/pricing 에서 볼 수 있습니다.

다른 업데이트

새 소식을 받아보세요

제품 업데이트를 이메일로 보내드립니다.

RSS 구독