# ID로 Google Shopping Product Info 결과 조회 **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/merchant/google/product_info/task_get/advanced/{id}` **Tags:** DataForSEO `post_dataforseo_merchant_google_product_info_submit`으로 대기열에 넣은 작업에서 가져온 Google Shopping 제품 하나의 상세 페이지입니다. 사양, 설명, 이미지, 그리고 이를 판매하는 판매자를 제공합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 `tasks[0].result`, 처리 결과는 `tasks[0].status_code`에 있으며, 거부된 요청도 HTTP 200을 반환합니다. 여기로 이어지는 검색 결과는 `get_dataforseo_merchant_google_products_fetch`, 구매자 의견은 `get_dataforseo_merchant_google_reviews_fetch`를 사용하세요. ### 가격 참고 - 과금 기준: 보고된 응답 비용. - 참고 요청 추정치: USD 0.012. - 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요. 참고용 메타데이터일 뿐이며, 계정 견적, 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `id` | path | yes | string | 작업 식별자
시스템 내 고유 작업 식별자(UUID 형식)
30일 이내에 언제든지 이 식별자로 작업 결과를 요청할 수 있습니다 | ## Responses ### 200 — 작업 성공 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo" } ] } ``` ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "API의 현재 버전" }, "status_code": { "type": [ "integer", "null" ], "description": "일반 상태 코드입니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다." }, "status_message": { "type": [ "string", "null" ], "description": "일반 정보 메시지입니다.\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다." }, "time": { "type": [ "string", "null" ], "description": "총 실행 시간(초)" }, "cost": { "type": [ "number", "null" ], "description": "전체 작업 비용, USD", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "tasks 배열의 작업 수", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "오류와 함께 반환된 tasks 배열의 작업 수", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "작업 식별자\n시스템 내 고유 작업 식별자(UUID 형식)" }, "status_code": { "type": [ "integer", "null" ], "description": "작업의 상태 코드\nDataForSEO가 생성하며 10000-60000 범위일 수 있습니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다." }, "status_message": { "type": [ "string", "null" ], "description": "작업의 정보 메시지\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다." }, "time": { "type": [ "string", "null" ], "description": "실행 시간, 초" }, "cost": { "type": [ "number", "null" ], "description": "전체 작업 비용, USD", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "result 배열의 요소 수", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "URL 경로" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "POST 요청에 지정한 것과 동일한 매개변수를 포함합니다" } } } ``` ### Response36Afe1097B20_DeliveryInfo `#/components/schemas/Response36Afe1097B20_DeliveryInfo` ```json { "type": "object", "properties": { "delivery_date_from": { "type": [ "string", "null" ], "description": "가장 빠른 배송 날짜
제품을 발송할 수 있는 가장 빠른 날짜(UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”)
예: 2019-11-15 12:57:46 +00:00" }, "delivery_date_to": { "type": [ "string", "null" ], "description": "가장 늦은 배송 날짜
제품을 배송할 수 있는 가장 늦은 날짜(UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”)
예: 2019-11-15 12:57:46 +00:00" }, "fastest_delivery_date_from": { "type": [ "string", "null" ], "description": "가장 빠른 무료 배송 날짜
빠른 배송 옵션으로 제품을 배송할 수 있는 가장 빠른 날짜(UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”)
예: 2019-11-15 12:57:46 +00:00" }, "fastest_delivery_date_to": { "type": [ "string", "null" ], "description": "가장 늦은 무료 배송 날짜
빠른 배송 옵션으로 제품을 배송할 수 있는 가장 늦은 날짜(UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”)
예: 2019-11-15 12:57:46 +00:00" }, "delivery_message": { "type": [ "string", "null" ], "description": "배송 정보
판매자가 게시한 배송 정보와 함께 제공되는 메시지" }, "delivery_price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ], "description": "배송 가격
POST 요청에 지정한 위치를 기준으로 한 배송 가격;
무료 배송이 가능한 경우 값은 null입니다" } } } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo" } ] }, "description": "작업 배열" } } } ] } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResultInfo` ```json { "type": "object", "properties": { "product_id": { "type": [ "string", "null" ], "description": "POST 배열의 제품 ID
이 매개변수에 대한 자세한 내용은 이 도움말 센터 가이드에서 확인하세요" }, "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "se_domain": { "type": [ "string", "null" ], "description": "POST 배열의 검색 엔진 도메인" }, "location_code": { "type": [ "integer", "null" ], "description": "POST 배열의 위치 코드" }, "language_code": { "type": [ "string", "null" ], "description": "POST 배열의 언어 코드" }, "check_url": { "type": [ "string", "null" ], "description": "검색 엔진 결과로의 직접 URL
이 URL로 우리가 정확한 결과를 제공했는지 확인할 수 있습니다" }, "datetime": { "type": [ "string", "null" ], "description": "결과를 수신한 날짜와 시간
형식: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
예:
2019-11-15 12:57:46 +00:00" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "제품 사양 페이지에서 발견된 항목 유형
가능한 항목 유형:
product_info_element" }, "items_count": { "type": [ "integer", "null" ], "description": "items 배열에서 반환된 결과 수", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductInfoElement" } ] }, "description": "제품 페이지의 항목
제품 페이지에 나열된 모든 제품 속성과 관련 데이터를 포함합니다" } } } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResultInfo" } ] }, "description": "결과 배열" } } } ] } ``` ### Response36Afe1097B20_PriceInfo `#/components/schemas/Response36Afe1097B20_PriceInfo` ```json { "type": "object", "properties": { "current": { "type": [ "number", "null" ], "description": "현재 가격\n결과에 표시된 제품 또는 서비스의 현재 가격을 나타냅니다", "format": "double" }, "regular": { "type": [ "number", "null" ], "description": "정가\n할인이 적용되지 않은 제품 또는 서비스의 정가를 나타냅니다", "format": "double" }, "max_value": { "type": [ "number", "null" ], "description": "최대 가격\n결과에 표시된 제품 또는 서비스의 최대 가격", "format": "double" }, "currency": { "type": [ "string", "null" ], "description": "표시된 가격의 통화\n가격에 적용되는 통화의 ISO 코드" }, "is_price_range": { "type": [ "boolean", "null" ], "description": "가격이 범위로 제공됨\n가격이 범위로 제공되는지 나타냅니다" }, "displayed_price": { "type": [ "string", "null" ], "description": "결과의 가격 문자열\n결과에 제공된 원시 가격 문자열" } } } ``` ### Response36Afe1097B20_ProductInfoElement `#/components/schemas/Response36Afe1097B20_ProductInfoElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "rank_group": { "type": [ "integer", "null" ], "description": "type 값이 동일한 요소 그룹 내 위치
type 값이 다른 요소의 위치는 rank_group에서 제외됩니다" }, "rank_absolute": { "type": [ "integer", "null" ], "description": "제품 사양 페이지의 절대 순위
제품 사양 페이지에서 발견된 모든 요소 중 절대 위치" }, "position": { "type": [ "string", "null" ], "description": "제품 사양 페이지에서 요소의 정렬
다음 값 중 하나를 가질 수 있습니다:
right, left" }, "product_id": { "type": [ "string", "null" ], "description": "POST 배열에서 받은 product_id
이 매개변수에 대한 자세한 내용은 이 도움말 센터 가이드에서 확인하세요" }, "title": { "type": [ "string", "null" ], "description": "제품 제목" }, "description": { "type": [ "string", "null" ], "description": "제품 설명" }, "url": { "type": [ "string", "null" ], "description": "제품 URL
Google Shopping의 제품 URL" }, "images": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "제품 이미지
제품 이미지의 URL을 포함합니다" }, "features": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "제품 특징
제품 특징 설명이 포함된 스니펫을 포함합니다" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement" } ], "description": "제품 평점
리뷰를 기반으로 한 인기도 점수" }, "seller_reviews_count": { "type": [ "integer", "null" ], "description": "판매자 리뷰 수
제품 판매자 계정의 리뷰 수", "format": "int64" }, "data_docid": { "type": [ "string", "null" ], "description": "SERP 데이터 요소의 고유 식별자
data_docid는 Google이 할당하는 동적 값이므로 가능한 값의 전체 목록은 없습니다
예:
17363035694596624076" }, "gid": { "type": [ "string", "null" ], "description": "Google Shopping의 글로벌 제품 식별자
gid는 Google이 할당하는 동적 값이므로 가능한 값의 전체 목록은 없습니다
값이 없으면 null이 반환됩니다
예:
4702526954592161872
gid에 대한 자세한 내용은 이 도움말 센터 가이드에서 확인하세요" }, "specifications": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ShoppingSpecification" } ] }, "description": "제품 사양
제품 사양 페이지에 나열된 모든 제품 속성과 관련 데이터를 포함합니다" }, "sellers": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductSeller" } ] }, "description": "제품 판매자
제품 판매자 계정의 리뷰 수" }, "variations": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductVariation" } ] }, "description": "제품 변형
다양한 제품 변형에 대한 간략한 정보를 포함합니다" } } } ``` ### Response36Afe1097B20_ProductSeller `#/components/schemas/Response36Afe1097B20_ProductSeller` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "title": { "type": [ "string", "null" ], "description": "제품 제목" }, "url": { "type": [ "string", "null" ], "description": "판매자 URL
제품이 판매되는 페이지의 URL" }, "seller_rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement" } ], "description": "판매자 평점" }, "seller_review_count": { "type": [ "integer", "null" ], "description": "판매자 리뷰 수\n제품 판매자 계정의 리뷰 수" }, "price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ], "description": "제품 가격
판매자 웹사이트의 제품 가격 세부 정보" }, "delivery_info": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DeliveryInfo" } ], "description": "배송 정보
제품 배송 정보" }, "product_availability": { "type": [ "string", "null" ], "description": "제품 가용성 정보
다음 값 중 하나를 가질 수 있습니다: in_stock, limited_stock, out_of_stock, backordered, pre_order_available, on_display_to_order" } } } ``` ### Response36Afe1097B20_ProductVariation `#/components/schemas/Response36Afe1097B20_ProductVariation` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "product_id": { "type": [ "string", "null" ], "description": "POST 배열의 제품 ID
이 매개변수에 대한 자세한 내용은 이 도움말 센터 가이드에서 확인하세요" }, "gid": { "type": [ "string", "null" ], "description": "POST 배열의 GID ID
이 매개변수에 대한 자세한 내용은 이 도움말 센터 가이드에서 확인하세요" }, "data_docid": { "type": [ "string", "null" ], "description": "POST 배열에서 SERP 데이터 요소의 고유 식별자" }, "pvf": { "type": [ "string", "null" ], "description": "제품 변형 필터
제품 변형 URL에서 특정 제품 변형의 식별자로 사용됩니다" }, "title": { "type": [ "string", "null" ], "description": "제품 판매자 이름" }, "url": { "type": [ "string", "null" ], "description": "Google Shopping의 제품 변형 URL" }, "variation_category": { "type": [ "string", "null" ], "description": "제품 변형의 카테고리
예: \"Storage Capacity\"" } } } ``` ### Response36Afe1097B20_RatingElement `#/components/schemas/Response36Afe1097B20_RatingElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "position": { "type": [ "string", "null" ], "description": "Google Shopping SERP에서 요소의 정렬
가능한 값:
left, right" }, "rating_type": { "type": [ "string", "null" ], "description": "평점 유형
여기에서 다음 요소를 확인할 수 있습니다: Max5, Percents, CustomMax" }, "value": { "type": [ "number", "null" ], "description": "평점 값" }, "votes_count": { "type": [ "integer", "null" ], "description": "피드백 수", "format": "int64" }, "rating_max": { "type": [ "integer", "null" ], "description": "rating_type의 최댓값" } } } ``` ### Response36Afe1097B20_ShoppingSpecification `#/components/schemas/Response36Afe1097B20_ShoppingSpecification` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "block_name": { "type": [ "string", "null" ], "description": "상품 속성 블록의 이름
관련 요소가 나열된 상품 사양 섹션의 이름을 나타냅니다" }, "specification_name": { "type": [ "string", "null" ], "description": "상품 속성
상품 데이터 사양의 속성 이름" }, "specification_value": { "type": [ "string", "null" ], "description": "사양 내용" } } } ```