Gemini 답변의 상품과 장소도 함께 받아요

GEMINI 결과에 Gemini가 답변에서 보여주는 상품 카드와 장소가 담겨요.

달라진 점

• shoppingCards: Gemini가 보여 주는 상품 카드입니다. 상품명, 순서, 가격, 판매처, 평점, 리뷰 수, 썸네일, Google 상품 페이지로 가는 productLink가 담깁니다.
• inlineProducts: 답변 문장 안에 링크된 상품으로, 상품명, 순서, productLink가 담깁니다.
• map: 장소를 묻는 질문에 Gemini가 추천한 장소로, 주소, 좌표, 전화번호, 웹사이트, Google 지도 링크, 평점, 업종이 담깁니다.

동작 방식

Gemini에 무엇을 살지, 어디에 갈지 물으면 답의 상당 부분이 본문 밖에 있습니다. 가격이 붙은 상품 카드 한 줄이나 지도 위 장소 목록이 그렇습니다. 이제 이 정보가 text 옆에 구조화된 필드로, Gemini가 보여 주는 순서대로 담기므로 position으로 어떤 상품이나 장소가 먼저 나왔는지 알 수 있습니다.

price는 {value, currency, raw} 형태라 판매처 간 가격을 비교하기 쉽습니다. 장소마다 placeId, address와 latitude, longitude가 담긴 location, 평점과 리뷰 수, 제공처가 담긴 reviews가 있습니다. 상품 카드 이름은 text에도 그대로 남아 있어, 답변 본문으로 언급을 세는 집계는 숫자가 그대로 유지됩니다.

이렇게 활용하세요

• 내 상품이 Gemini 상품 카드에 나오는지, 몇 번째에 어떤 가격으로 나오는지 추적합니다.
• 내 카테고리에서 Gemini가 어느 판매처로 구매자를 보내는지 확인합니다.
• 동네별로 Gemini가 추천하는 병원, 식당, 매장과 평점을 확인합니다.

요청 보내기

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": "GEMINI",
    "payload": {
      "prompt": "Best ramen near me",
      "country": "US",
      "location": "East Village, 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에서 씁니다.

payload.include.markdownboolean

true면 제목, 목록, 표, 링크를 살린 markdown을 함께 받습니다.

응답

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

{
  "success": true,
  "task": {
    "id": "685aad4a-3191-4215-9d2a-93ada8376185",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:51:49.105Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "**[IPPUDO NY](https://maps.google.com/?cid=13390953617500975094)** · ★ 4.4 (5,519) · Restaurant · 65 4th Ave, New York, NY 10003\n…",
    "map": [
      {
        "position": 4,
        "name": "IPPUDO NY",
        "category": "Restaurant",
        "location": {
          "address": "65 4th Ave, New York, NY 10003",
          "latitude": 40.730948,
          "longitude": -73.990287
        },
        "reviews": [
          { "count": 5519, "rating": 4.4, "providerName": "Google" }
        ],
        "phoneNumber": "+1 212-388-0088",
        "url": "https://www.ippudous.com/east-village",
        "mapsUrl": "https://maps.google.com/?cid=13390953617500975094"
      }
    ],
    "location": {
      "name": "East Village, Manhattan Community Board 3, Manhattan, New York County, New York, 10003, United States",
      "query": "East Village, New York",
      "latitude": 40.72927,
      "longitude": -73.98736,
      "precision": "neighbourhood"
    }
  }
}

response.maparray

답변이 추천한 장소입니다. 이름, 주소, 좌표, 평점, 업종, 지도 링크가 담깁니다.

response.shoppingCardsarray

답변과 함께 나온 상품 카드입니다. 상품명, 가격, 판매처, 평점, 상품 링크가 담깁니다.

response.inlineProductsarray

답변 문장 안에 링크로 걸린 상품명입니다. position, productLink가 담깁니다.

response.locationobject

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

결과 받기

요청하면 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크레딧이며, 상품과 장소도 포함됩니다.