# ID로 Amazon ASIN 결과 조회 **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/merchant/amazon/asin/task_get/advanced/{id}` **Tags:** DataForSEO `post_dataforseo_merchant_amazon_asin_submit`으로 대기열에 넣은 작업에서 가져온 Amazon 제품 페이지 하나입니다. `asin`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `item_types`, `items_count`, `items`를 반환하며, 각 항목에는 `title`, `details`, `image_url`, `author`, `data_asin`, `parent_asin`, `product_asins`가 있습니다. 마지막 필드는 변형 제품군으로, 다른 사이즈나 색상을 찾는 방법입니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 `tasks[0].result`, 처리 결과는 `tasks[0].status_code`에 있으며, 거부된 요청도 HTTP 200을 반환합니다. 파싱된 결과에서 특정해 짚을 수 있는 항목이 빠졌을 때만 사용하세요. ### 가격 참고 - 과금 기준: 보고된 응답 비용. - 참고 요청 추정치: 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_MerchantAmazonAsinTaskGetAdvancedResponseInfo" } ] } ``` ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AiModeImagesElementInfo `#/components/schemas/Response36Afe1097B20_AiModeImagesElementInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "alt": { "type": [ "string", "null" ], "description": "이미지의 alt 태그" }, "url": { "type": [ "string", "null" ], "description": "관련 URL" }, "image_url": { "type": [ "string", "null" ], "description": "이미지 URL
원본 리소스 또는 DataForSEO 스토리지(원본 소스를 사용할 수 없는 경우)에 있는 이미지로 연결되는 URL" } } } ``` ### Response36Afe1097B20_AmazonApplicableVouchersItem `#/components/schemas/Response36Afe1097B20_AmazonApplicableVouchersItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "text": { "type": [ "string", "null" ], "description": "바우처 텍스트" }, "fixed_discount": { "type": [ "number", "null" ], "description": "고정 할인 값" }, "fixed_discount_currency": { "type": [ "string", "null" ], "description": "고정 할인의 통화 코드" }, "percentage_discount": { "type": [ "number", "null" ], "description": "비율 할인 값
할인이 고정형이면 값은 null입니다" }, "important_details": { "type": [ "string", "null" ], "description": "할인 바우처 약관에 대한 중요한 세부 정보" } } } ``` ### Response36Afe1097B20_AmazonProductInfo `#/components/schemas/Response36Afe1097B20_AmazonProductInfo` ```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": "Amazon SERP에서 요소의 정렬
가능한 값:
left, right" }, "xpath": { "type": [ "string", "null" ], "description": "요소의 XPath" }, "title": { "type": [ "string", "null" ], "description": "제품 제목" }, "details": { "type": [ "string", "null" ], "description": "제품 사양 및 기타 세부 정보" }, "image_url": { "type": [ "string", "null" ], "description": "제품 이미지의 URL" }, "author": { "type": [ "string", "null" ], "description": "제품 브랜드 이름" }, "data_asin": { "type": [ "string", "null" ], "description": "POST 배열에서 받은 제품의 ASIN" }, "parent_asin": { "type": [ "string", "null" ], "description": "제품의 상위 ASIN" }, "product_asins": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "발견된 모든 제품 변형의 ASIN" }, "price_from": { "type": [ "number", "null" ], "description": "제품 가격 범위의 하한
예:
49.98" }, "price_to": { "type": [ "number", "null" ], "description": "제품 가격 범위의 상한
예:
384.99" }, "percentage_discount": { "type": [ "string", "null" ], "description": "할인율 값" }, "currency": { "type": [ "string", "null" ], "description": "ISO 형식의 통화
예:
USD" }, "is_amazon_choice": { "type": [ "boolean", "null" ], "description": "“Amazon's choice” 라벨
값이 true이면 제품에 “Amazon's choice” 라벨이 표시됩니다" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement" } ], "description": "제품 평점 정보" }, "is_newer_model_available": { "type": [ "boolean", "null" ], "description": "제품의 최신 모델 사용 가능 여부를 나타냅니다" }, "is_prime_video": { "type": [ "boolean", "null" ], "description": "제품에 Amazon Prime Video 라벨이 있는지 나타냅니다
true이면 지정한 제품이 Amazon Prime Video 서비스의 일부입니다" }, "applicable_vouchers": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonApplicableVouchersItem" } ] }, "description": "적용 가능한 바우처 정보를 담은 객체 배열" }, "newer_model": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_NewerModel" } ], "description": "제품의 최신 모델 정보" }, "categories": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_Categories" } ] }, "description": "관련 제품 카테고리를 포함합니다" }, "product_information": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseMerchantAmazonProductInformationElementItem" } ] }, "description": "관련 제품 정보를 포함합니다" }, "product_images_list": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "기본 이미지 왼쪽에 표시되는 제품의 모든 이미지 URL을 포함합니다" }, "product_videos_list": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "기본 동영상 오른쪽에 표시되는 제품의 모든 동영상 URL을 포함합니다" }, "description": { "type": [ "string", "null" ], "description": "제품 설명을 포함합니다" }, "is_available": { "type": [ "boolean", "null" ], "description": "제품의 주문 가능 여부를 나타냅니다
값이 true이면 제품을 주문할 수 있습니다" }, "top_local_reviews": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonReviewItem" } ] }, "description": "대상 위치의 상위 리뷰를 담은 객체 배열" }, "top_global_reviews": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonReviewItem" } ] }, "description": "전 세계 상위 리뷰를 담은 객체 배열" } } } ``` ### Response36Afe1097B20_AmazonReviewItem `#/components/schemas/Response36Afe1097B20_AmazonReviewItem` ```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": "SERP에서 리뷰의 정렬
가능한 값: right" }, "xpath": { "type": [ "string", "null" ], "description": "요소의 XPath" }, "verified": { "type": [ "boolean", "null" ], "description": "리뷰에 \"Verified Purchase\" 표시가 있는지 나타냅니다" }, "subtitle": { "type": [ "string", "null" ], "description": "리뷰 부제목" }, "helpful_votes": { "type": [ "string", "null" ], "description": "도움돼요 투표 수
리뷰 텍스트 아래 'Helpful' 버튼을 클릭한 사용자 수" }, "images": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AiModeImagesElementInfo" } ] }, "description": "리뷰어가 제출한 제품 이미지" }, "videos": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_VideoElement" } ] }, "description": "리뷰어가 제출한 제품 동영상" }, "user_profile": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_UserProfileInfo" } ], "description": "리뷰어의 사용자 프로필" }, "title": { "type": [ "string", "null" ], "description": "리뷰 제목" }, "url": { "type": [ "string", "null" ] }, "review_text": { "type": [ "string", "null" ], "description": "리뷰 내용" }, "publication_date": { "type": [ "string", "null" ], "description": "리뷰가 게시된 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”;
예:
2019-11-15 12:57:46 +00:00" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo" } ], "description": "리뷰어가 제출한 평점" } } } ``` ### Response36Afe1097B20_BaseMerchantAmazonProductInformationElementItem `#/components/schemas/Response36Afe1097B20_BaseMerchantAmazonProductInformationElementItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "section_name": { "type": [ "string", "null" ], "description": "contents에 지정된 제품 정보와 관련된 섹션 이름" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "product_information_details_item": "#/components/schemas/Response36Afe1097B20_ProductInformationProductInformationDetailsItem", "product_information_text_item": "#/components/schemas/Response36Afe1097B20_ProductInformationProductInformationTextItem", "product_information_extended_item": "#/components/schemas/Response36Afe1097B20_ProductInformationProductInformationExtendedItem" } } } ``` ### 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_Categories `#/components/schemas/Response36Afe1097B20_Categories` ```json { "type": "object", "properties": { "category": { "type": [ "string", "null" ], "description": "제품 카테고리 이름" }, "url": { "type": [ "string", "null" ], "description": "제품 카테고리 URL
고유한 브라우즈 노드 ID(Amazon의 제품 카테고리 ID)가 포함된 Amazon의 브라우즈 경로를 나타냅니다" } } } ``` ### Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResponseInfo` ```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_MerchantAmazonAsinTaskGetAdvancedTaskInfo" } ] }, "description": "작업 배열" } } } ] } ``` ### Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResultInfo` ```json { "type": "object", "properties": { "asin": { "type": [ "string", "null" ], "description": "POST 배열에서 수신한 ASIN
POST 배열에서 수신한 Amazon의 고유 제품 식별자(ASIN)입니다.
이 식별자에 대한 자세한 내용은 이 도움말 센터 가이드에서 확인하세요" }, "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "se_domain": { "type": [ "string", "null" ], "description": "POST 배열의 Amazon 도메인" }, "location_code": { "type": [ "integer", "null" ], "description": "POST 배열의 위치 코드" }, "language_code": { "type": [ "string", "null" ], "description": "POST 배열의 언어 코드" }, "check_url": { "type": [ "string", "null" ], "description": "Amazon 결과로의 직접 URL
정확한 결과를 제공했는지 확인하는 데 사용할 수 있습니다" }, "datetime": { "type": [ "string", "null" ], "description": "결과를 받은 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:
2019-11-15 12:57:46 +00:00" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "Amazon에서 발견된 검색 결과 유형
반환된 SERP에서 발견된 모든 검색 결과(items)의 유형을 포함합니다.
가능한 항목 유형:
amazon_product_info" }, "items_count": { "type": [ "integer", "null" ], "description": "items 배열에서 반환된 결과 수", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonProductInfo" } ] }, "description": "Amazon 제품 정보 항목" } } } ``` ### Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedTaskInfo` ```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_MerchantAmazonAsinTaskGetAdvancedResultInfo" } ] }, "description": "결과 배열" } } } ] } ``` ### Response36Afe1097B20_NewerModel `#/components/schemas/Response36Afe1097B20_NewerModel` ```json { "type": "object", "properties": { "title": { "type": [ "string", "null" ], "description": "제품 제목" }, "newer_model_asin": { "type": [ "string", "null" ], "description": "최신 제품 모델의 ASIN" } } } ``` ### 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_RatingInfo `#/components/schemas/Response36Afe1097B20_RatingInfo` ```json { "properties": { "rating_type": { "type": [ "string", "null" ], "description": "평점 유형\n여기에서 다음 요소를 확인할 수 있습니다: Max5, Percents, CustomMax" }, "value": { "type": [ "number", "null" ], "description": "평점 값", "format": "double" }, "votes_count": { "type": [ "integer", "null" ], "description": "피드백 수", "format": "int64" }, "rating_max": { "type": [ "integer", "null" ], "description": "rating_type의 최댓값" } } } ``` ### Response36Afe1097B20_UserProfileInfo `#/components/schemas/Response36Afe1097B20_UserProfileInfo` ```json { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "avatar": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ], "description": "관련 URL" }, "reviews_count": { "type": [ "integer", "null" ], "format": "int64" }, "locations": { "type": [ "string", "null" ] } } } ``` ### Response36Afe1097B20_VideoElement `#/components/schemas/Response36Afe1097B20_VideoElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "source": { "type": [ "string", "null" ], "description": "동영상 소스 URL" }, "preview": { "type": [ "string", "null" ], "description": "동영상 미리보기 이미지 URL" }, "title": { "type": [ "string", "null" ], "description": "주어진 링크 요소의 제목" }, "timestamp": { "type": [ "string", "null" ], "description": "결과가 게시된 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:
2019-11-15 12:57:46 +00:00" }, "url": { "type": [ "string", "null" ], "description": "소스 URL" } } } ```