# 실시간 Google Dataset Search 고급 **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/serp/google/dataset_search/live/advanced` **Tags:** DataForSEO Google Dataset Search에서 쿼리와 일치하는 데이터 세트를 동기식으로 반환합니다. `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.02. - 참고 고객 배수: 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”로 지정하세요;


DataForSEO API의 keyword 및 keywords 필드 규칙과 제한은 이 Help Center 문서에서 확인하세요

" }, "language_code": { "type": [ "string", "null" ], "description": "

검색 엔진 언어 코드

language_name을 지정하지 않으면 선택 필드

이 필드를 사용하면 language_name을 지정할 필요가 없습니다

가능한 값:

en

" }, "depth": { "type": [ "integer", "null" ], "description": "

파싱 깊이

선택 필드

SERP의 결과 수

기본값: 20

최댓값: 200


계정에는 최대 20개 결과를 포함하는 각 SERP마다 요금이 청구됩니다;

검색 엔진이 20개를 초과하는 결과를 반환하면 깊이를 20보다 높게 설정할 때 추가 요금이 발생할 수 있습니다;

지정한 깊이가 응답의 결과 수보다 많으면 그 차액은 계정 잔액으로 자동 환불됩니다." }, "device": { "type": [ "string", "null" ], "description": "

기기 유형

선택 필드

특정 기기 유형의 결과를 반환합니다

가능한 값: desktop

" }, "language_name": { "type": [ "string", "null" ], "description": "

검색 엔진 언어의 전체 이름

선택 필드

이 필드를 사용하면 language_code를 지정할 필요가 없습니다

가능한 값:

English

" }, "os": { "type": [ "string", "null" ], "description": "

기기 운영 체제

선택 필드

다음 값 중에서 선택하세요: windows, macos

기본값: windows

" }, "tag": { "type": [ "string", "null" ], "description": "

사용자 정의 작업 식별자

선택 필드

최대 255자

이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다

지정한 tag 값은 응답의 data 객체에서 확인할 수 있습니다

" }, "last_updated": { "type": [ "string", "null" ], "description": "

데이터세트가 마지막으로 업데이트된 시점

선택 필드

가능한 값: 1m, 1y, 3y

" }, "file_formats": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "

데이터세트 파일 형식

선택 필드

가능한 값: other, archive, text, image, document, tabular

" }, "usage_rights": { "type": [ "string", "null" ], "description": "

데이터세트 사용 권한

선택 필드

가능한 값: commercial, noncommercial

" }, "is_free": { "type": [ "boolean", "null" ], "description": "

표시된 데이터세트가 무료인지 여부

선택 필드

가능한 값: true, false

" }, "topics": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "

데이터세트 주제

선택 필드

가능한 값: humanities, social_sciences, life_sciences, agriculture, natural_sciences, geo, computer, architecture_and_urban_planning, engineering

" } }, "example": [ { "keyword": "water quality", "last_updated": "1m", "file_formats": [ "archive", "image" ], "usage_rights": "noncommercial", "is_free": true, "topics": [ "natural_sciences", "geo" ] } ] } ] }, "example": [ { "keyword": "water quality", "last_updated": "1m", "file_formats": [ "archive", "image" ], "usage_rights": "noncommercial", "is_free": true, "topics": [ "natural_sciences", "geo" ] } ] } ``` ## Responses ### 200 — 작업 성공 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedResponseInfo" } ] } ``` ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### 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_AuthorsElement `#/components/schemas/Response36Afe1097B20_AuthorsElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "name": { "type": [ "string", "null" ], "description": "데이터세트 작성자 이름" }, "url": { "type": [ "string", "null" ], "description": "작성자의 링크 URL" }, "domain": { "type": [ "string", "null" ], "description": "작성자의 링크 도메인" } } } ``` ### 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_Dataset `#/components/schemas/Response36Afe1097B20_Dataset` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "rank_group": { "type": [ "integer", "null" ], "description": "SERP 그룹 순위
type 값이 동일한 요소 그룹 내의 위치
type 값이 다른 요소의 위치는 rank_group에서 제외됩니다" }, "rank_absolute": { "type": [ "integer", "null" ], "description": "SERP 절대 순위
SERP의 모든 요소 중 절대 위치" }, "position": { "type": [ "string", "null" ], "description": "SERP에서 요소의 정렬
다음 값을 사용할 수 있습니다:
left, right" }, "xpath": { "type": [ "string", "null" ], "description": "요소의 XPath" }, "dataset_id": { "type": [ "string", "null" ], "description": "데이터세트 ID" }, "title": { "type": [ "string", "null" ], "description": "요소 제목" }, "image_url": { "type": [ "string", "null" ], "description": "이미지 URL
원본 리소스 또는 DataForSEO 스토리지(원본 소스를 사용할 수 없는 경우)에 있는 이미지로 연결되는 URL" }, "scholarly_citations_count": { "type": [ "integer", "null" ], "description": "데이터세트를 참조하는 문서 수", "format": "int64" }, "scholarly_articles_url": { "type": [ "string", "null" ], "description": "학술 논문 URL
Google Scholar의 학술 논문 목록 링크
예: https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22" }, "unique_identifier": { "type": [ "string", "null" ], "description": "객체의 디지털 식별자
데이터세트의 고유 디지털 식별자
예: https://doi.org/10.5061/dryad.hmgqnk9m3" }, "related_article": { "type": [ "string", "null" ], "description": "관련 문서 링크
데이터세트와 관련된 게시 문서 링크" }, "links": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_LinkElement" } ] }, "description": "사이트링크
Google Dataset 검색 결과 일부 아래에 표시되는 링크
없으면 null과 같습니다" }, "dataset_providers": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement" } ] }, "description": "데이터세트를 제공한 기관 목록" }, "formats": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_FormatsElement" } ] }, "description": "데이터세트의 파일 형식 목록" }, "authors": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AuthorsElement" } ] }, "description": "데이터세트의 저자 목록" }, "licenses": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement" } ] }, "description": "데이터세트에 발급된 라이선스 목록" }, "updated_date": { "type": [ "string", "null" ], "description": "결과가 마지막으로 업데이트된 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:
2022-11-27 02:00:00 +00:00" }, "area_covered": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "데이터세트에 포함된 지역 목록
예: Africa, Global" }, "period_covered": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PeriodCovered" } ], "description": "데이터세트에 포함된 기간" }, "dataset_description": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DatasetDescription" } ], "description": "데이터세트 설명" } } } ``` ### Response36Afe1097B20_DatasetDescription `#/components/schemas/Response36Afe1097B20_DatasetDescription` ```json { "type": "object", "properties": { "text": { "type": [ "string", "null" ], "description": "설명 텍스트" }, "links": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_LinkElement" } ] }, "description": "'dataset_description'에 포함된 링크" } } } ``` ### Response36Afe1097B20_FormatsElement `#/components/schemas/Response36Afe1097B20_FormatsElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "format": { "type": [ "string", "null" ], "description": "데이터세트의 파일 형식 유형
예: zip, html, csv" }, "size": { "type": [ "integer", "null" ], "description": "파일 크기(바이트)", "format": "int64" } } } ``` ### Response36Afe1097B20_LinkElement `#/components/schemas/Response36Afe1097B20_LinkElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "요소 유형" }, "title": { "type": [ "string", "null" ], "description": "지정된 링크 요소의 제목" }, "snippet": { "type": [ "string", "null" ], "description": "링크 제목 옆의 텍스트" }, "description": { "type": [ "string", "null" ], "description": "결과 요소의 설명" }, "url": { "type": [ "string", "null" ], "description": "URL" }, "domain": { "type": [ "string", "null" ], "description": "링크가 가리키는 도메인" }, "xpath": { "type": [ "string", "null" ], "description": "요소의 XPath" } } } ``` ### Response36Afe1097B20_PeriodCovered `#/components/schemas/Response36Afe1097B20_PeriodCovered` ```json { "type": "object", "properties": { "start_date": { "type": [ "string", "null" ], "description": "기간이 시작되는 날짜 및 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:
2020-03-02 02:00:00 +00:00" }, "end_date": { "type": [ "string", "null" ], "description": "기간이 종료되는 날짜 및 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:
2022-12-09 02:00:00 +00:00" }, "displayed_date": { "type": [ "string", "null" ], "description": "SERP에 표시되는 기간
예:
Mar 2, 2020 - Dec 9, 2022" } } } ``` ### Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedResponseInfo` ```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_SerpGoogleDatasetSearchLiveAdvancedTaskInfo" } ] }, "description": "작업 배열" } } } ] } ``` ### Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "POST 배열에서 수신한 키워드
키워드는 %##이 디코딩된 상태로 반환됩니다('+' 문자는 공백 문자로 디코딩됨)" }, "se_domain": { "type": [ "string", "null" ], "description": "POST 배열의 검색 엔진 도메인" }, "language_code": { "type": [ "string", "null" ], "description": "POST 배열의 언어 코드" }, "check_url": { "type": [ "string", "null" ], "description": "검색 엔진 결과로의 직접 URL
이 URL로 우리가 정확한 결과를 제공했는지 확인할 수 있습니다" }, "datetime": { "type": [ "string", "null" ], "description": "결과를 받은 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:
2019-11-15 12:57:46 +00:00" }, "spell": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo" } ], "description": "검색 엔진의 자동 교정
검색 엔진이 교정된 키워드에 대한 결과를 제공한 경우, 검색 엔진이 교정한 키워드와 자동 교정 유형을 명시합니다" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "SERP의 검색 결과 유형
SERP에서 발견된 검색 결과 유형(items)을 포함합니다.
가능한 항목 유형: dataset" }, "se_results_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_Dataset" } ] }, "description": "요소의 항목" } } } ``` ### Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedTaskInfo` ```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_SerpGoogleDatasetSearchLiveAdvancedResultInfo" } ] }, "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" } } } ```