체인지로그새 기능

검색 결과와 Reddit이 추가됐어요

Search results
Playground에 나란히 놓인 Google Search 결과와 Reddit 게시물

Google, Bing, Naver 검색 결과와 Reddit 토론을 AI 답변과 같은 API로, JSON으로 받아요.

받는 결과

  • GOOGLE_SERP: 순위, 제목, 링크, 요약문이 담긴 일반 검색 결과와 관련 질문, 관련 검색어, 광고입니다. page를 1~10으로 지정하면 뒤 페이지도 받습니다.
  • BING_SEARCH: Bing 검색 결과와, Bing이 결과 위에 쓰는 AI 요약을 출처와 함께 aioverview로 받습니다.
  • NAVER_SERP: 네이버 웹문서를 페이지마다 15개씩 받고, page는 1~10입니다.
  • REDDIT: 게시글 검색, 댓글을 포함한 게시글 하나, 서브레딧의 최신 글 목록을 받습니다.

동작 방식

AI 엔진은 웹에서 답변을 만들기 때문에, 검색에서 상위에 오르는 페이지와 사람들이 Reddit에 쓰는 글이 곧 AI 노출의 재료입니다. 이 엔진들은 그 데이터를 이미 쓰는 흐름 그대로 가져옵니다. 같은 요청, 같은 webhook, 같은 JSON 형식입니다.

순위는 페이지를 이어서 셉니다. Google 2페이지의 첫 결과는 11위입니다. 태스크마다 수집 시점의 실제 결과를 읽습니다.

이렇게 활용하세요

  • 같은 검색어에서 검색 상위 사이트와 AI 답변이 인용하는 사이트를 비교합니다.
  • 내 카테고리에서 여론을 만드는 Reddit 글을 따라갑니다.

요청 보내기

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

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GOOGLE_SERP",
    "payload": {
      "query": "best project management software for small teams",
      "country": "US"
    }
  }'

BING_SEARCH, NAVER_SERP도 payload에 query를 넣어 같은 방식으로 보냅니다.

요청 필드

taskTypestring필수
실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.
payload.querystring필수
사용자가 검색창에 입력하듯 쓴 검색어입니다.
payload.countrystring
질문할 시장의 두 글자 국가 코드입니다. US, KR, JP 등. 기본값 US.
payload.pageinteger
읽을 결과 페이지, 1에서 10. 기본값 1. position은 페이지를 넘어 이어서 셉니다.
webhook.urlstring
서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.
idempotencyKeystring
요청에 붙이는 고유 ID입니다. 키 하나는 계정에서 태스크 하나를 만들므로, 다시 보내도 태스크는 하나로 유지됩니다.

응답

완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.

JSON
{
  "success": true,
  "task": {
    "id": "323287e6-d4ef-4797-a337-f6c3b574b7ab",
    "taskType": "GOOGLE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:45:07.237Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "page": 1,
    "organicResults": [
      {
        "position": 1,
        "title": "8 Easy-to-Use Project Management Software Platforms for ...",
        "link": "https://ones.com/blog/8-easy-to-use-project-management-software-platforms-for-small-teams/?primary_category=knowledge",
        "snippet": "1 day ago — ONES.com came out on top for teams that need Jira-like power without the complexity, while Trello and Asana hold their ground for basic, visual ...",
        "page": 1
      }
    ],
    "peopleAlsoAsk": [
      { "question": "Does Microsoft Teams have a project management tool?" },
      {
        "question": "What is the best project management software for a small construction company?"
      }
    ]
  }
}
task.statusstring
QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.
credits.creditsChargedinteger
끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.
response.organicResultsarray
페이지의 검색 결과입니다. position, title, link, snippet, page가 담깁니다.
response.peopleAlsoAskarray
구글이 페이지에 보여 준 관련 질문입니다.

Reddit 검색

REDDIT에 query를 보내면 게시물을 찾고, subreddit을 더하면 한 커뮤니티 안에서 찾습니다. 게시물 url을 보내면 그 게시물과 첫 페이지 댓글을 읽습니다.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "REDDIT",
    "payload": {
      "query": "best mechanical keyboard for programming",
      "country": "US"
    }
  }'

완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.

JSON
{
  "success": true,
  "task": {
    "id": "fe0a46a2-7bf1-4cd0-8183-d299dc421c70",
    "taskType": "REDDIT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:47:44.384Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "results": [
      {
        "url": "https://www.reddit.com/r/MechanicalKeyboardsUK/comments/1qz6da6/best_silent_mechanical_keyboard_for_programming/",
        "title": "Best silent mechanical keyboard for programming?",
        "postId": "1qz6da6",
        "preview": "I currently have a mechanical keyboard but I often wake up in the middle of the night and it is quite loud so I can't use my computer because …",
        "subreddit": "MechanicalKeyboardsUK"
      }
    ]
  }
}
payload.subredditstring
서브레딧 하나 안에서 검색합니다. r/ 뒤의 이름을 넣습니다.
payload.urlstring
게시물 주소 https://www.reddit.com/r/{subreddit}/comments/{postId}/…입니다. 게시물 본문과 첫 페이지 댓글을 읽습니다.
payload.commentSortstring
댓글 정렬: top(기본값), new, controversial, old, qa.
response.resultsarray
검색에 맞는 게시물입니다. postId, title, url, subreddit, preview가 담깁니다.
response.postobject
게시물 url로 요청하면 제목, 본문, 작성자, 점수, 댓글 수가 담깁니다.
response.commentsobject
첫 페이지 댓글 약 20~25개입니다. 작성자, 본문, 점수, 깊이가 담깁니다.

결과 받기

요청하면 status가 QUEUED인 태스크가 바로 돌아옵니다. status가 COMPLETED나 FAILED가 될 때까지 GET /v1/async/task/{id}로 조회하거나, webhook.url을 넣어 같은 task, credits, response를 서버로 받으세요. 결과는 태스크가 끝난 뒤 24시간 동안 조회됩니다.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

요금

완료된 태스크마다 1크레딧이 차감됩니다.

다른 업데이트

새 소식을 받아보세요

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

RSS 구독