# 실시간 Google 유기적 SERP 고급 **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/serp/google/organic/live/advanced` **Tags:** DataForSEO Google에서 키워드의 순위 결과를 동기식으로 반환합니다. `keyword`, `type`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `spell`, `refinement_chips`, `item_types`, `items_count`, `items`를 반환합니다. `advanced`가 기본 선택입니다. 순위 목록만 필요하면 `regular`, 파서가 누락한 항목을 확인하려면 `html`을 선택하세요. DataForSEO 응답 봉투로 감싸집니다. 데이터는 `tasks[0].result`, 처리 결과는 `tasks[0].status_code`에 있으며, 거부된 요청도 HTTP 200을 반환합니다. ### 가격 참고 - 과금 기준: 응답에 보고된 비용. - 참고 요청 추정치: USD 0.0175. - 참고 고객 배수: 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`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "keyword": { "type": "string", "description": "키워드 필수 필드 keyword 필드에는 최대 700자까지 지정할 수 있습니다 모든 %##이 디코딩됩니다(‘+’ 문자는 공백 문자로 디코딩됨) keyword에 “%” 문자를 사용해야 하는 경우 “%25”로 지정하세요; keyword에 “+” 문자를 사용해야 하는 경우 “%2B”로 지정하세요; 이 필드에 ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’ 같은 매개변수가 포함되면 작업당 요금이 5배가 됩니다 DataForSEO API의 keyword 및 keywords 필드 규칙과 제한은 이 Help Center 문서에서 확인하세요" }, "location_code": { "type": [ "integer", "null" ], "description": "검색 엔진 위치 코드 location_name 또는 location_coordinate를 지정하지 않으면 필수 필드 이 필드를 사용하면 location_name 또는 location_coordinate를 지정할 필요가 없습니다 사용 가능한 검색 엔진 위치와 해당 location_code 목록은 https://api.dataforseo.com/v3/serp/google/locations로 별도 요청해 받을 수 있습니다 예: 2840" }, "language_code": { "type": [ "string", "null" ], "description": "검색 엔진 언어 코드 선택 필드는 language_name을 지정하는 경우 language_name을 지정하지 않으면 필수 필드입니다 이 필드를 사용하면 language_name을 지정할 필요가 없습니다 사용 가능한 검색 엔진 언어와 해당 language_code 목록은 https://api.dataforseo.com/v3/serp/google/languages로 별도 요청해 받을 수 있습니다 예: en" }, "depth": { "type": [ "integer", "null" ], "description": "파싱 깊이 선택 필드 SERP 결과 수 기본값: 10 최댓값: 200 최대 10개 결과를 포함하는 각 SERP마다 계정에 요금이 청구됩니다; 깊이를 10보다 크게 설정하면 검색 엔진이 10개를 초과하는 결과를 반환할 때 추가 요금이 발생할 수 있습니다; 비용은 Pricing 페이지에서 계산할 수 있습니다." }, "device": { "type": [ "string", "null" ], "description": "기기 유형 선택 필드 특정 기기 유형의 결과 반환 다음 값 중에서 선택하세요: desktop, mobile 기본값: desktop" }, "load_async_ai_overview": { "type": [ "boolean", "null" ], "description": "비동기 AI 개요 로드 선택 필드 비동기로 로드되더라도 SERP에서 ai_overview 항목을 얻으려면 true로 설정하세요; false로 설정하면 캐시의 ai_overview 항목만 얻습니다; 기본값: false 참고: 이 매개변수를 사용하면 $0.002가 추가로 청구됩니다; 요소가 없거나 \"asynchronous_ai_overview\": false를 포함하면 모든 추가 요금이 계정 잔액으로 환불됩니다" }, "location_name": { "type": [ "string", "null" ], "description": "검색 엔진 위치의 전체 이름 location_code 또는 location_coordinate를 지정하지 않으면 필수 필드 이 필드를 사용하면 location_code 또는 location_coordinate를 지정할 필요가 없습니다 사용 가능한 검색 엔진 위치와 해당 location_name 목록은 https://api.dataforseo.com/v3/serp/google/locations로 별도 요청해 받을 수 있습니다 예: London,England,United Kingdom" }, "language_name": { "type": [ "string", "null" ], "description": "검색 엔진 언어의 전체 이름 선택 필드는 language_code를 지정하는 경우 language_code를 지정하지 않으면 필수 필드입니다 이 필드를 사용하면 language_code를 지정할 필요가 없습니다 사용 가능한 검색 엔진 언어와 해당 language_name 목록은 https://api.dataforseo.com/v3/serp/google/languages로 별도 요청해 받을 수 있습니다 예: English" }, "os": { "type": [ "string", "null" ], "description": "기기 운영 체제 선택 필드 device 필드에 desktop을 지정하면 다음 값 중에서 선택하세요: windows, macos 기본값: windows device 필드에 mobile을 지정하면 다음 값 중에서 선택하세요: android, ios 기본값: android" }, "tag": { "type": [ "string", "null" ], "description": "사용자 정의 작업 식별자 선택 필드 최대 255자 이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다 tag에 지정한 값은 응답의 data 객체에서 확인할 수 있습니다" }, "stop_crawl_on_match": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "match_value": { "type": [ "string", "null" ], "description": "대상 도메인 또는 와일드카드 값\nstop_crawl_on_match를 지정하면 필수 필드입니다;\n대상 도메인 또는 와일드카드 값을 지정하세요;\n참고: 도메인 이름은 요청 프로토콜 없이 지정해야 합니다;\n예: dataforseo.com" }, "match_type": { "type": [ "string", "null" ], "description": "대상 일치 유형\nstop_crawl_on_match를 지정하면 필수 필드입니다;\nmatch_value의 일치 유형\n가능한 값: domain, with_subdomains, wildcard" } } } ] }, "description": "크롤링을 중지할 대상 배열\n선택 필드\n지정하면 응답에 지정한 match_value까지 포함한 SERP 결과가 포함됩니다;\n이 배열에는 대상 값을 최대 10개까지 지정할 수 있습니다\n예:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\n이 매개변수에 대한 자세한 내용은 Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api 에서 확인하세요\n지정한 대상을 통해 크롤링된 각 SERP마다 계정에 요금이 청구됩니다" }, "match_type": { "type": [ "string", "null" ], "description": "대상 일치 유형 stop_crawl_on_match를 지정하면 필수 필드 match_value의 일치 유형 가능한 값: domain – 특정 도메인 또는 하위 도메인 with_subdomains – 기본 도메인 및 하위 도메인 wildcard – 와일드카드 패턴" }, "match_value": { "type": [ "string", "null" ], "description": "대상 도메인, 하위 도메인 또는 와일드카드 값 stop_crawl_on_match를 지정하면 필수 필드 대상 도메인, 하위 도메인 또는 와일드카드 값을 지정하세요; 참고: 도메인 또는 하위 도메인은 요청 프로토콜 없이 지정해야 합니다; 예: \"match_value\": \"dataforseo.com\", \"match_value\": \"/blog/post-*\"" }, "max_crawl_pages": { "type": [ "integer", "null" ], "description": "페이지 크롤 한도 선택 필드 크롤할 검색 결과 페이지 수 최댓값: 100 참고: 크롤한 각 페이지에 대해 요금이 청구됩니다(페이지당 유기적 결과 10개); 가격은 Pricing 페이지에서 확인하세요; 참고#2: max_crawl_pages와 depth 매개변수는 서로 보완합니다; 자세한 내용은 도움말 센터에서 확인하세요" }, "search_param": { "type": [ "string", "null" ], "description": "검색 쿼리의 추가 매개변수 선택 필드 사용 가능한 매개변수 목록과 자세한 내용은 여기에서 확인하세요 참고: 다음 검색 엔진 매개변수는 지원되지 않으며 지정하면 자동으로 해제됩니다: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype." }, "remove_from_url": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "URL에서 특정 매개변수 제거 선택 필드 이 필드를 사용하면 결과의 URL에서 제거할 매개변수를 최대 10개까지 지정할 수 있습니다 예: \"remove_from_url\": [\"srsltid\"] 참고: target 필드를 지정하면 검색 전에 지정한 URL 매개변수가 제거됩니다" }, "people_also_ask_click_depth": { "type": [ "integer", "null" ], "description": "해당 요소 클릭 수 선택 필드 추가 people_also_ask_element 항목을 얻으려면 people_also_ask 요소의 클릭 깊이를 지정하세요; 참고: 클릭할 때마다 계정에 $0.00015가 추가로 청구됩니다; 요소가 없거나 지정한 횟수보다 적게 클릭하면 모든 추가 요금이 계정 잔액으로 환불됩니다 가능한 값: 1~4" }, "group_organic_results": { "type": [ "boolean", "null" ], "description": "관련 결과 표시 선택 필드 true로 설정하면 응답의 related_result 요소가 상위 유기적 결과의 스니펫으로 제공됩니다; false로 설정하면 related_result 요소가 별도의 유기적 결과로 제공됩니다; 기본값: true" }, "calculate_rectangles": { "type": [ "boolean", "null" ], "description": "고급 결과에서 SERP 요소의 픽셀 순위 계산 선택 필드 픽셀 순위는 결과 스니펫과 화면 왼쪽 위 모서리 사이의 거리를 의미합니다; 자세한 내용은 Help Center에서 확인하세요>> 기본적으로 이 매개변수는 false로 설정됩니다; 참고: 이 매개변수를 사용하면 $0.002가 추가로 청구됩니다" }, "browser_screen_width": { "type": [ "integer", "null" ], "description": "브라우저 화면 너비 선택 필드 특정 기기의 픽셀 순위를 계산하도록 사용자 지정 브라우저 화면 너비를 설정할 수 있습니다; 다음 범위 내에서 지정할 수 있습니다: 240-9999; 기본적으로 이 매개변수는 다음과 같이 설정됩니다: 데스크톱 1920; android 모바일 360; iOS 모바일 375; 참고: 이 매개변수를 사용하려면 calculate_rectangles를 true로 설정하세요", "format": "int64" }, "browser_screen_height": { "type": [ "integer", "null" ], "description": "브라우저 화면 높이 선택 필드 특정 기기의 픽셀 순위를 계산하도록 사용자 지정 브라우저 화면 높이를 설정할 수 있습니다; 다음 범위 내에서 지정할 수 있습니다: 240-9999; 기본적으로 이 매개변수는 다음과 같이 설정됩니다: 데스크톱 1080; android 모바일 640; iOS 모바일 812; 참고: 이 매개변수를 사용하려면 calculate_rectangles를 true로 설정하세요" }, "browser_screen_resolution_ratio": { "type": [ "integer", "null" ], "description": "브라우저 화면 해상도 비율 선택 필드 특정 기기의 픽셀 순위를 계산하도록 사용자 지정 브라우저 화면 해상도 비율을 설정할 수 있습니다; 다음 범위 내에서 지정할 수 있습니다: 0.5-3; 기본적으로 이 매개변수는 다음과 같이 설정됩니다: 데스크톱 1; android 모바일 3; iOS 모바일 3; 참고: 이 매개변수를 사용하려면 calculate_rectangles를 true로 설정하세요" }, "url": { "type": [ "string", "null" ], "description": "검색 쿼리의 직접 URL 선택 필드 직접 URL을 지정하면 필요한 필드로 정리해 드립니다. 다만 이 방식은 API가 처리하기 가장 어려우며 URL에 정확한 언어와 위치를 지정해야 합니다. 대부분의 경우 이 방식은 권장하지 않습니다. 예: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS 참고: 다음 검색 엔진 매개변수는 지원되지 않으며 지정하면 자동으로 해제됩니다: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype." }, "location_coordinate": { "type": [ "string", "null" ], "description": "위치의 GPS 좌표 location_name 또는 location_code를 지정하는 경우 선택 필드 이 필드를 사용하면 location_name 또는 location_code를 지정할 필요가 없습니다 location_coordinate 매개변수는 \"latitude,longitude,radius\" 형식으로 지정해야 합니다 \"latitude\"와 \"longitude\"의 최대 소수점 자릿수: 7 \"radius\"의 최솟값: 199 (mm) \"radius\"의 최댓값: 199999 (mm) 예: 53.476225,-2.243572,200" }, "se_domain": { "type": [ "string", "null" ], "description": "검색 엔진 도메인 선택 필드 지정한 위치와 언어에 따라 관련 검색 엔진 도메인을 자동으로 선택합니다 그러나 이 필드에서 사용자 지정 검색 엔진 도메인을 설정할 수 있습니다 예: google.co.uk, google.com.au, google.de 등" }, "target": { "type": [ "string", "null" ], "description": "결과를 받을 대상 도메인, 하위 도메인 또는 웹페이지 선택 필드 도메인 또는 하위 도메인은 https://와 www. 없이 지정해야 합니다 target별 작업의 결과에는 url 문자열이 포함된 SERP 요소만 포함됩니다; 와일드카드(‘*’) 문자를 사용해 SERP의 검색 패턴을 지정하고 결과 범위를 좁힐 수도 있습니다; 예: example.com - https://example.com, https://www.example.com/, https://example.com/ 같은 URL의 웹사이트 홈 페이지 결과를 반환합니다; example.com* - 모든 페이지를 포함해 도메인의 결과를 반환합니다; *example.com* - 모든 페이지와 하위 도메인을 포함해 전체 도메인의 결과를 반환합니다; *example.com - 하위 도메인에 관계없이 https://en.example.com 같은 홈 페이지 결과를 반환합니다; example.com/example-page - 정확한 URL의 결과를 반환합니다; example.com/example-page* - 지정한 문자열로 시작하는 모든 도메인 URL의 결과를 반환합니다" }, "target_search_mode": { "type": [ "string", "null" ], "description": "대상 일치 모드 선택 필드 이 매개변수를 사용하려면 stop_crawl_on_match도 활성화해야 합니다 stop_crawl_on_match에 여러 대상이 지정된 경우 크롤을 중지하는 방법을 정의합니다 가능한 값: all, any all – 지정한 모든 대상을 찾았을 때만 크롤을 중지합니다 any – 단일 대상이라도 찾으면 크롤을 중지합니다 기본값: any 이 매개변수에 대한 자세한 내용은 Help Center에서 확인하세요" }, "find_targets_in": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "대상 확인용 SERP 요소 유형 선택 필드 이 매개변수를 사용하려면 stop_crawl_on_match도 활성화해야 합니다 대상 일치 여부를 확인할 SERP 요소 유형을 지정합니다 지정하지 않으면 url 및 domain 필드가 있는 모든 1차 요소에서 대상을 확인합니다 가능한 값: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter 참고: ignore_targets_in과 동일한 요소 유형을 포함할 수 없습니다 예: \"find_targets_in\": [\"organic\", \"featured_snippet\"] 이 매개변수에 대한 자세한 내용은 Help Center에서 확인하세요" }, "ignore_targets_in": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "대상 검색에서 제외할 SERP 요소 유형 선택 필드 이 매개변수를 사용하려면 stop_crawl_on_match도 활성화해야 합니다 대상 일치를 검색할 때 제외할 SERP 요소 유형을 지정합니다 가능한 값: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter 참고: find_targets_in과 동일한 요소 유형을 포함할 수 없습니다 예: \"ignore_targets_in\": [\"paid\", \"images\"] 이 매개변수에 대한 자세한 내용은 Help Center에서 확인하세요" } }, "example": [ { "language_code": "en", "location_code": 2840, "keyword": "albert einstein", "calculate_rectangles": true } ] } ] }, "example": [ { "language_code": "en", "location_code": 2840, "keyword": "albert einstein", "calculate_rectangles": true } ] } ``` ## Responses ### 200 — 작업 성공 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo" } ] } ``` ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AiModeRectangleInfo `#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo` ```json { "type": "object", "properties": { "x": { "type": [ "number", "null" ], "description": "x축 좌표\n결과 스니펫 왼쪽 위 모서리의 x축 좌표이며, 화면 왼쪽 위 모서리가 원점입니다", "format": "double" }, "y": { "type": [ "number", "null" ], "description": "y축 좌표\n결과 스니펫 왼쪽 위 모서리의 y축 좌표이며, 화면 왼쪽 위 모서리가 원점입니다", "format": "double" }, "width": { "type": [ "number", "null" ], "description": "요소의 너비(픽셀)", "format": "double" }, "height": { "type": [ "number", "null" ], "description": "요소의 높이(픽셀)", "format": "double" } } } ``` ### Response36Afe1097B20_AmazonLabelElement `#/components/schemas/Response36Afe1097B20_AmazonLabelElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "title": { "type": [ "string", "null" ], "description": "요소의 제목" }, "url": { "type": [ "string", "null" ], "description": "필터 매개변수가 포함된 검색 URL" }, "domain": { "type": [ "string", "null" ], "description": "SERP 내 도메인" } } } ``` ### 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_BaseSerpApiElementItem `#/components/schemas/Response36Afe1097B20_BaseSerpApiElementItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "page": { "type": [ "integer", "null" ], "description": "검색 결과 페이지 번호
요소가 위치한 SERP 페이지 번호를 나타냅니다" }, "position": { "type": [ "string", "null" ], "description": "SERP에서 요소의 정렬
다음 값을 사용할 수 있습니다:
left, right" }, "xpath": { "type": [ "string", "null" ], "description": "요소의 XPath" }, "rectangle": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo" } ], "description": "직사각형 매개변수
SERP에서 결과 스니펫의 직교 좌표와 픽셀 크기를 포함합니다
POST 요청의 calculate_rectangles가 true로 설정되지 않은 경우 null입니다" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "paid": "#/components/schemas/Response36Afe1097B20_PaidSerpElementItem", "organic": "#/components/schemas/Response36Afe1097B20_OrganicSerpElementItem", "featured_snippet": "#/components/schemas/Response36Afe1097B20_FeaturedSnippetSerpElementItem", "knowledge_graph": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphSerpElementItem", "top_stories": "#/components/schemas/Response36Afe1097B20_TopStoriesSerpElementItem", "people_also_ask": "#/components/schemas/Response36Afe1097B20_PeopleAlsoAskSerpElementItem", "people_also_search": "#/components/schemas/Response36Afe1097B20_PeopleAlsoSearchSerpElementItem", "images": "#/components/schemas/Response36Afe1097B20_ImagesSerpElementItem", "twitter": "#/components/schemas/Response36Afe1097B20_TwitterSerpElementItem", "google_reviews": "#/components/schemas/Response36Afe1097B20_GoogleReviewsSerpElementItem", "jobs": "#/components/schemas/Response36Afe1097B20_JobsSerpElementItem", "map": "#/components/schemas/Response36Afe1097B20_MapSerpElementItem", "app": "#/components/schemas/Response36Afe1097B20_AppSerpElementItem", "local_pack": "#/components/schemas/Response36Afe1097B20_LocalPackSerpElementItem", "carousel": "#/components/schemas/Response36Afe1097B20_CarouselSerpElementItem", "video": "#/components/schemas/Response36Afe1097B20_VideoSerpElementItem", "answer_box": "#/components/schemas/Response36Afe1097B20_AnswerBoxSerpElementItem", "shopping": "#/components/schemas/Response36Afe1097B20_ShoppingSerpElementItem", "google_flights": "#/components/schemas/Response36Afe1097B20_GoogleFlightsSerpElementItem", "events": "#/components/schemas/Response36Afe1097B20_EventsSerpElementItem", "related_searches": "#/components/schemas/Response36Afe1097B20_RelatedSearchesSerpElementItem", "multi_carousel": "#/components/schemas/Response36Afe1097B20_MultiCarouselSerpElementItem", "recipes": "#/components/schemas/Response36Afe1097B20_RecipesSerpElementItem", "top_sights": "#/components/schemas/Response36Afe1097B20_TopSightsSerpElementItem", "scholarly_articles": "#/components/schemas/Response36Afe1097B20_ScholarlyArticlesSerpElementItem", "popular_products": "#/components/schemas/Response36Afe1097B20_PopularProductsSerpElementItem", "stocks_box": "#/components/schemas/Response36Afe1097B20_StocksBoxSerpElementItem", "find_results_on": "#/components/schemas/Response36Afe1097B20_FindResultsOnSerpElementItem", "questions_and_answers": "#/components/schemas/Response36Afe1097B20_QuestionsAndAnswersSerpElementItem", "hotels_pack": "#/components/schemas/Response36Afe1097B20_HotelsPackSerpElementItem", "commercial_units": "#/components/schemas/Response36Afe1097B20_CommercialUnitsSerpElementItem", "local_services": "#/components/schemas/Response36Afe1097B20_LocalServicesSerpElementItem", "google_hotels": "#/components/schemas/Response36Afe1097B20_GoogleHotelsSerpElementItem", "math_solver": "#/components/schemas/Response36Afe1097B20_MathSolverSerpElementItem", "currency_box": "#/components/schemas/Response36Afe1097B20_CurrencyBoxSerpElementItem", "product_considerations": "#/components/schemas/Response36Afe1097B20_ProductConsiderationsSerpElementItem", "short_videos": "#/components/schemas/Response36Afe1097B20_ShortVideosSerpElementItem", "refine_products": "#/components/schemas/Response36Afe1097B20_RefineProductsSerpElementItem", "perspectives": "#/components/schemas/Response36Afe1097B20_PerspectivesSerpElementItem", "discussions_and_forums": "#/components/schemas/Response36Afe1097B20_DiscussionsAndForumsSerpElementItem", "compare_sites": "#/components/schemas/Response36Afe1097B20_CompareSitesSerpElementItem", "knowledge_graph_carousel_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphCarouselItemSerpElementItem", "knowledge_graph_description_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphDescriptionItemSerpElementItem", "knowledge_graph_images_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphImagesItemSerpElementItem", "knowledge_graph_list_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphListItemSerpElementItem", "knowledge_graph_row_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphRowItemSerpElementItem", "knowledge_graph_hotels_booking_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphHotelsBookingItemSerpElementItem", "knowledge_graph_expanded_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphExpandedItemSerpElementItem", "knowledge_graph_part_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphPartItemSerpElementItem", "knowledge_graph_shopping_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphShoppingItemSerpElementItem", "knowledge_graph_ai_overview_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphAiOverviewItemSerpElementItem", "ai_overview": "#/components/schemas/Response36Afe1097B20_AiOverviewSerpElementItem", "third_party_reviews": "#/components/schemas/Response36Afe1097B20_ThirdPartyReviewsSerpElementItem", "dictionary": "#/components/schemas/Response36Afe1097B20_DictionarySerpElementItem", "google_posts": "#/components/schemas/Response36Afe1097B20_GooglePostsSerpElementItem", "mention_carousel": "#/components/schemas/Response36Afe1097B20_MentionCarouselSerpElementItem", "podcasts": "#/components/schemas/Response36Afe1097B20_PodcastsSerpElementItem", "visual_stories": "#/components/schemas/Response36Afe1097B20_VisualStoriesSerpElementItem", "found_on_web": "#/components/schemas/Response36Afe1097B20_FoundOnWebSerpElementItem", "explore_brands": "#/components/schemas/Response36Afe1097B20_ExploreBrandsSerpElementItem", "courses": "#/components/schemas/Response36Afe1097B20_CoursesSerpElementItem" } } } ``` ### Response36Afe1097B20_RefinementChipsElement `#/components/schemas/Response36Afe1097B20_RefinementChipsElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "title": { "type": [ "string", "null" ], "description": "요소의 제목" }, "url": { "type": [ "string", "null" ], "description": "필터 매개변수가 포함된 검색 URL" }, "domain": { "type": [ "string", "null" ], "description": "SERP 내 도메인" }, "options": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement" } ] }, "description": "추가 검색 세분화 옵션" } } } ``` ### Response36Afe1097B20_RefinementChipsInfo `#/components/schemas/Response36Afe1097B20_RefinementChipsInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "xpath": { "type": [ "string", "null" ], "description": "요소의 XPath" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement" } ] }, "description": "요소의 항목" } } } ``` ### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo` ```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_SerpGoogleOrganicLiveAdvancedTaskInfo" } ] }, "description": "작업 배열" } } } ] } ``` ### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "POST 배열에서 받은 키워드. 키워드는 %##가 디코딩된 상태로 반환됩니다('+' 문자가 공백 문자로 디코딩됨)." }, "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\n정확한 결과가 제공되었는지 확인하는 데 사용할 수 있습니다" }, "datetime": { "type": [ "string", "null" ], "description": "결과를 받은 날짜와 시간\nUTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”\n예:\n2019-11-15 12:57:46 +00:00" }, "spell": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo" } ], "description": "검색 엔진의 자동 교정\n검색 엔진이 교정된 키워드에 대한 결과를 제공한 경우, 검색 엔진이 교정한 키워드와 자동 교정 유형을 명시합니다" }, "refinement_chips": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo" } ], "description": "검색 세분화 칩" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "SERP의 검색 결과 유형. SERP에서 발견된 검색 결과 유형(items)을 포함합니다. 가능한 항목 유형: answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview" }, "se_results_count": { "type": [ "integer", "null" ], "description": "SERP의 총 결과 수", "format": "int64" }, "pages_count": { "type": [ "integer", "null" ], "description": "검색된 총 검색 결과 페이지 수. 결과에서 검색된 SERP의 총수.", "format": "int64" }, "items_count": { "type": [ "integer", "null" ], "description": "items 배열에 반환된 결과 수", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseSerpApiElementItem" } ] }, "description": "요소의 항목" } } } ``` ### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo` ```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_SerpGoogleOrganicLiveAdvancedResultInfo" } ] }, "description": "결과 배열" } } } ] } ``` ### Response36Afe1097B20_SpellInfo `#/components/schemas/Response36Afe1097B20_SpellInfo` ```json { "properties": { "keyword": { "type": [ "string", "null" ], "description": "검색 엔진 자동 교정 결과로 얻은 키워드\n교정된 키워드에 대한 결과가 제공됩니다" }, "type": { "type": [ "string", "null" ], "description": "자동 교정 유형\n가능한 값:\ndid_you_mean, showing_results_for, no_results_found_for, including_results_for\n참고: Yahoo와 Yandex는 다음 자동 교정 유형만 지원합니다.\nincluding_results_for" } } } ```