ChatGPT와 Gemini에 정확한 위치를 지정할 수 있어요

CHATGPT, GEMINI 태스크에 payload.location을 넣어 그 장소의 사용자가 보는 답변을 받으세요.

받는 결과

• 동네 기준 답변: 역, 매장, 길모퉁이처럼 지정한 지점 주변을 기준으로 추천이 나옵니다.
• 위치를 지정한 결과의 location: 답변에 적용된 좌표가 담깁니다.
• Playground에서도 같은 기능: 국가 버튼 옆 위치 (선택) 칸에 장소나 좌표를 입력하세요.

동작 방식

“근처 괜찮은 치과”, “점심 먹을 곳” 같은 질문의 답은 사용자가 있는 곳에 따라 달라집니다. ChatGPT와 Gemini는 사용자 위치를 기준으로 답하므로, 같은 질문에도 강남과 부산에서 추천하는 병원이 다릅니다. payload.location에 태스크 country 안의 좌표를 넣으면 querying.ai가 그 자리에 있는 사용자로서 엔진에 질문합니다.

좌표는 아래 요청처럼 latitude와 longitude를 십진 도 단위로 보냅니다. 지도 앱에서 고른 지점의 숫자를 그대로 쓰면 되고, Playground는 장소 이름으로 좌표를 찾아 줍니다. 결과의 location에 같은 좌표가 돌아옵니다.

위치 지정은 CHATGPT, GEMINI, GOOGLE, AIMODE, GOOGLE_SERP 태스크에서 씁니다. 제출하는 순간 엔진을 확인하고 그 밖의 엔진에는 LOCATION_UNSUPPORTED를 돌려주므로, 실행되는 태스크는 모두 지정한 장소를 기준으로 답합니다.

이렇게 활용하세요

• 내 병원, 식당, 매장이 그 동네 사용자에게 AI 추천으로 나오는지 확인합니다.
• 같은 질문을 여러 동네와 도시에서 던져 경쟁사가 앞서는 지역을 찾습니다.
• 프랜차이즈 지점마다 그 지점 주소를 기준으로 질문 세트를 추적합니다.

요청 보내기

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": "Best coffee shops near me for working on a laptop",
      "country": "US",
      "location": { "latitude": 40.72288, "longitude": -73.99875 }
    }
  }'

요청 필드

taskTypestring필수

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

payload.promptstring필수

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

payload.countrystring

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

payload.locationobject

country 안의 지점입니다. latitude(-90~90)와 longitude(-180~180)를 십진수 도 단위로 넣습니다. 예: {"latitude": 37.4979, "longitude": 127.0276}. 엔진이 그 자리에 있는 사용자에게 답하듯 답합니다. CHATGPT, GEMINI, GOOGLE, AIMODE, GOOGLE_SERP에서 씁니다.

webhook.urlstring

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

idempotencyKeystring

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

응답

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

{
  "success": true,
  "task": {
    "id": "e5aba119-a26e-4f82-a965-35c9234a428b",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:41:03.858Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "Here are several **nearby cafés that look particularly suitable for laptop work**, based on current local listings and work-friendly details:\n\n- The Lost Draft — **0.2 km away**. Laptop-friendly, with Wi-Fi, comfortable seating, and larger tables.\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://awifiplace.com/cities/new-york",
        "label": "Best Coffee Shops to Work in New York (2026) | 103 Cafes with WiFi",
        "attribution": "A Wifi.Place"
      }
    ],
    "searchQueries": [
      "best coffee shops for laptop work near me wifi outlets"
    ],
    "location": { "latitude": 40.72288, "longitude": -73.99875 }
  }
}

task.statusstring

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

credits.creditsChargedinteger

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

response.textstring

답변 평문입니다.

response.locationobject

답변에 적용된 지점입니다. 보낸 그대로 latitude, longitude가 담깁니다.

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_UNSUPPORTEDHTTP 422

payload.location은 CHATGPT, GEMINI, GOOGLE, AIMODE, GOOGLE_SERP에서 씁니다. 그 밖의 엔진은 제출할 때 이 코드를 돌려줍니다.

요금

위치를 지정해도 요금은 엔진의 기본 요금 그대로입니다. 완료된 태스크마다 ChatGPT는 2크레딧, Gemini는 1크레딧입니다.