이제 ChatGPT, Gemini, Google에서 중국 본토를 지원해요

CHATGPT, GEMINI, GOOGLE 태스크의 country를 CN이나 HK로 정해 중국 본토와 홍콩 사용자가 보는 답변을 받으세요.

달라진 점

• CHATGPT 태스크의 중국 본토: country: "CN"을 보내면 ChatGPT가 중국 본토 사용자에게 답하듯 답합니다. 기본 위치는 베이징입니다.
• CHATGPT 태스크의 홍콩: country: "HK"를 보내면 홍콩 사용자에게 답하듯 답합니다. 기본 위치는 Central(中環)입니다.
• GEMINI 태스크의 중국 본토: country: "CN"을 보내면 Gemini가 중국 본토 사용자에게 답하듯 답합니다. 기본 위치는 베이징입니다.
• GOOGLE 태스크의 중국 본토: country: "CN"을 보내면 중국 본토 사용자가 Google에서 보는 AI Overview를 받습니다. 기본 위치는 베이징입니다.
• 두 시장 모두 payload.location으로 정확한 장소를 지정합니다. 베이징의 王府井, 홍콩의 旺角처럼 적으면 결과에 location으로 돌아옵니다.

동작 방식

CN, HK 태스크는 기기 위치가 그 시장에 있는 사용자로서 ChatGPT에 질문합니다. 기본 위치는 베이징과 Central이고, payload.location을 넣으면 그 장소입니다. 주변 장소를 묻는 질문에는 그 지점을 기준으로 답합니다. 王府井에서 附近有什么药店？를 물으면 312~938m 거리의 약국 6곳을 바이두 지도를 인용해 답했습니다.

GEMINI의 CN 태스크도 같은 지점의 기기로 Gemini에 질문합니다. 위치 없이 附近有什么药店？를 물으면 운영 확인 11번 모두 베이징 前门 일대에서 400~650m 떨어진 약국을 Google 지도 링크와 함께 답했습니다. 王府井에서는 가장 가까운 약국이 350m였습니다.

GOOGLE의 CN 태스크는 중국 본토 사용자가 Google에 접속하는 방식 그대로, Google 국제 검색 결과(gl=us)를 베이징이나 payload.location의 장소에 있는 기기로 엽니다. AI Overview와 organic 결과 모두 그 페이지에서 나옵니다. 운영 환경에서 모바일 결제, 배달 앱, 예금 금리, 휴대폰, 전기 이륜차, 온라인 쇼핑, 관광지를 간체 중국어로 물은 7개 질문 모두 본토 기준의 간체 중국어 AI Overview를 받았습니다. 手机支付用哪个好？에는 微信支付와 支付宝를, 外卖软件用哪个最好？에는 美团과 饿了么를 들었습니다. 附近有什么药店？에는 베이징 西城区의 약국을, 王府井에서는 王府井大街의 약국을 나열했습니다. AIMODE의 CN 태스크도 간체 중국어로 본토 기준 답을 돌려줍니다.

시장 전반을 묻는 질문은 그 시장의 언어로 쓰세요. 예금 금리, 배달 앱, 모바일 결제를 간체 중국어로 물으면 ChatGPT는 45번 중 42번 본토 시장 기준으로 답하며 美团, 淘宝闪购, 京东外卖, 支付宝, 微信支付와 본토 은행을 언급했고, 나머지 3번은 어느 지역 기준인지 먼저 되물었습니다. Gemini는 모바일 결제, 예금 금리, 관광지 질문 23번 모두 본토 기준으로 답했고, 배달 앱 질문 11번 모두 美团과 饿了么를 먼저 들었으며 그중 8번은 DoorDash 같은 해외 앱도 함께 언급했습니다. 광둥어로 外賣app邊個最好？를 물으면 ChatGPT는 홍콩의 배달 앱 Keeta와 foodpanda로 답했습니다.

payload.location에는 태스크 시장 안의 장소를 넣습니다. CN은 중국 본토, HK는 홍콩의 장소입니다. 현지 표기 그대로 200자까지 적으세요. 장소를 보내면 결과의 location에 적용된 장소, 좌표, 일치한 장소의 종류가 담깁니다.

아래 예시는 CHATGPT 태스크입니다. Gemini는 taskType을 GEMINI로 바꾸고, Google AI Overview는 GOOGLE로 바꾼 뒤 질문을 payload.query에 넣으세요.

이렇게 활용하세요

• 간체 중국어 질문으로 ChatGPT, Gemini, Google AI Overview가 중국 본토 소비자에게 내 브랜드를 어떻게 추천하는지 추적합니다.
• 같은 질문을 각 시장의 언어로 던져 중국 본토와 홍콩에서 엔진마다 언급하는 앱, 은행, 매장을 비교합니다.
• 중국 본토와 홍콩의 매장마다 그 주변에서 엔진들이 추천하는 매장, 식당, 병원을 확인합니다.

요청 보내기

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": "CHATGPT",
    "payload": { "prompt": "附近有什么药店？", "country": "CN", "location": "王府井" }
  }'

요청 필드

taskTypestring필수

실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.

payload.promptstring필수

사용자가 채팅에 입력하듯 쓴 질문입니다. 최대 100,000자.

payload.countrystring

질문할 시장의 두 글자 국가 코드입니다. US, KR, JP 등. 기본값 US.

payload.locationstring

country 안의 장소입니다. 역, 구, 도로명주소 등 최대 200자. 엔진이 그 자리에 있는 사용자에게 답하듯 답합니다. CHATGPT, GEMINI, GOOGLE, AIMODE, GOOGLE_SERP에서 씁니다.

webhook.urlstring

서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.

idempotencyKeystring

요청에 붙이는 고유 ID입니다. 키 하나는 계정에서 태스크 하나를 만들므로, 다시 보내도 태스크는 하나로 유지됩니다.

응답

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

{
  "success": true,
  "task": {
    "id": "6e6625b6-2d91-4f17-88a5-9b53df805960",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-03T17:25:13.462Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "你附近目前有这些药店：\n\n- 低价药房顺鸿堂药店 — 约 **354 米**\n- 正义药店 — 约 **312 米**\n- 龙华康健大药房 — 约 **514 米**\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://map.baidu.com/mobile/webapp/place/list/…",
        "label": "百度地图",
        "attribution": "map.baidu.com"
      }
    ],
    "searchQueries": ["北京 东城区 附近 药店 营业时间"],
    "location": {
      "name": "王府井, 王府井大街, 台基厂社区, 东华门街道, 首都功能核心区, 东城区, 北京市, 100010, 中国",
      "query": "王府井",
      "latitude": 39.90695,
      "longitude": 116.40528,
      "precision": "railway"
    }
  }
}

task.statusstring

QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.

credits.creditsChargedinteger

끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.

response.textstring

답변 평문입니다.

response.locationobject

답변에 적용된 장소입니다. query, name, latitude, longitude, precision이 담깁니다.

response.sourcesarray

답변이 인용한 페이지입니다. 엔진이 보여 준 순서대로 position, url, label이 담깁니다.

response.searchQueriesarray

엔진이 답을 쓰려고 실행한 웹 검색어입니다.

결과 받기

요청하면 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"

오류

LOCATION_NOT_FOUNDHTTP 422

country 안에서 payload.location의 장소를 찾지 못했습니다. 구나 시를 덧붙여 다시 보내세요.

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

장소 조회가 잠시 멈췄습니다. 같은 요청을 다시 보내면 앞서 찾은 장소는 바로 처리됩니다.

요금

CN, HK 태스크의 요금은 같은 엔진의 다른 태스크와 같습니다. 완료된 태스크마다 ChatGPT 2크레딧, Gemini 1크레딧, Google AI Overview 2크레딧입니다.