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

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

받는 결과

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

동작 방식

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

장소는 현지에서 쓰는 이름 그대로 200자까지 적으세요. “강남역”, “서울 강남구”, 도로명주소 모두 됩니다. 여러 도시에 같은 이름이 있으면 구나 시를 덧붙이세요. 결과에는 적용된 장소가 기록됩니다.

• location.query: 보낸 텍스트입니다.
• location.name: 일치한 장소로, 그 시장의 표기로 적힙니다.
• location.latitude, location.longitude: 엔진이 답한 지점의 좌표입니다.
• location.precision: 일치한 장소의 종류로, railway(역), suburb(동네), city(도시) 등이 있습니다.

위치 지정은 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": "SoHo, New York"
    }
  }'

요청 필드

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": "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": {
      "name": "SoHo, Manhattan, New York County, New York, 10012, United States",
      "query": "SoHo, New York",
      "latitude": 40.72288,
      "longitude": -73.99875,
      "precision": "neighbourhood"
    }
  }
}

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

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

LOCATION_NOT_FOUNDHTTP 422

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

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

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

요금

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