DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
실시간 Google 유기적 SERP HTML
Google에서 키워드의 순위 결과를 동기식으로 반환합니다. 파싱된 결과가 아니라 원본 페이지 소스입니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result, 처리 결과는 tasks[0].status_code에 있으며, 거부된 요청도 HTTP 200을 반환합니다.
가격 참고
- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.02.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: array (object | null)[]
- depth유형: integer | null
파싱 깊이
선택 필드
SERP 결과 수
기본값:
10최댓값:
200
최대 10개 결과를 포함하는 각 SERP마다 계정에 요금이 청구됩니다;깊이를 10보다 크게 설정하면 검색 엔진이 10개를 초과하는 결과를 반환할 때 추가 요금이 발생할 수 있습니다;
비용은 Pricing 페이지에서 계산할 수 있습니다.
- device유형: string | null
기기 유형
선택 필드
특정 기기 유형의 결과 반환
다음 값 중에서 선택하세요:
desktop,mobile기본값:
desktop - expand유형: boolean | null
_ai _overview AI 개요 펼치기
선택 필드
true로 설정하여ai_overview항목을 펼칩니다;기본값:
false - find유형: array string[] | null
_targets _in 대상 확인용 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유형: array string[] | null
_targets _in 대상 검색에서 제외할 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에서 확인하세요
- keyword유형: string
키워드
필수 필드
keyword필드에는 최대 700자까지 지정할 수 있습니다모든 %##이 디코딩됩니다('+' 문자는 공백 문자로 디코딩됨)
keyword에 "%" 문자를 사용해야 하는 경우 "%25"로 지정하세요;keyword에 “+” 문자를 사용해야 하는 경우 “%2B”로 지정하세요;이 필드에 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', ‘cache:’, 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:' 같은 매개변수가 포함되면 작업당 요금이 5배가 됩니다
- language유형: string
_code 검색 엔진 언어 코드
language_name을 지정하지 않으면 필수 필드이 필드를 사용하면
language_name을 지정할 필요가 없습니다사용 가능한 검색 엔진 언어와 해당
language_code목록은https://api.dataforseo.com/v3/serp/google/languages예:
en - language유형: string
_name 검색 엔진 언어의 전체 이름
language_code를 지정하지 않으면 필수 필드이 필드를 사용하면
language_code를 지정할 필요가 없습니다사용 가능한 검색 엔진 언어와 해당
language_name목록은https://api.dataforseo.com/v3/serp/google/languages로 별도 요청해 받을 수 있습니다예:
English - load유형: boolean | null
_async _ai _overview 비동기 AI 개요 로드
선택 필드
true로 설정하면 비동기로 로드되더라도 SERP에서ai_overview항목을 얻습니다;false로 설정하면 캐시의ai_overview항목만 얻습니다;기본값:
false참고 요청마다 계정에 $0.002가 추가로 청구됩니다;
요소가 없거나
"asynchronous_ai_overview": false를 포함하면 모든 추가 요금이 계정 잔액으로 환불됩니다 - location유형: integer
_code 검색 엔진 위치 코드
location_name또는location_coordinate를 지정하지 않으면 필수 필드이 필드를 사용하면
location_name또는location_coordinate를 지정할 필요가 없습니다사용 가능한 검색 엔진 위치와 해당
location_code목록은https://api.dataforseo.com/v3/serp/google/locations로 별도 요청해 받을 수 있습니다예:
2840 - location유형: string
_coordinate 위치의 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 - location유형: string
_name 검색 엔진 위치의 전체 이름
location_code또는location_coordinate를 지정하지 않으면 필수 필드이 필드를 사용하면
location_code또는location_coordinate를 지정할 필요가 없습니다사용 가능한 검색 엔진 위치와 해당
location_name목록은https://api.dataforseo.com/v3/serp/google/locations로 별도 요청해 받을 수 있습니다예:
London,England,United Kingdom - match유형: string
_type 대상 일치 유형
stop_crawl_on_match를 지정하면 필수 필드match_value의 일치 유형가능한 값:
domain– 특정 도메인 또는 하위 도메인with_subdomains– 기본 도메인 및 하위 도메인wildcard– 와일드카드 패턴 - match유형: string
_value 대상 도메인, 하위 도메인 또는 와일드카드 값
stop_crawl_on_match를 지정하면 필수 필드대상 도메인, 하위 도메인 또는 와일드카드 값을 지정하세요;
참고: 도메인 또는 하위 도메인은 요청 프로토콜 없이 지정해야 합니다;
예:
"match_value": "dataforseo.com","match_value": "/blog/post-*" - max유형: integer | null
_crawl _pages - os유형: string | null
기기 운영 체제
선택 필드
desktop을device필드에 지정하면 다음 값 중에서 선택하세요:windows,macos기본값:
windowsmobile을device필드에 지정하면 다음 값 중에서 선택하세요:android,ios기본값:
android - se유형: string | null
_domain 검색 엔진 도메인
선택 필드
지정한 위치와 언어에 따라 관련 검색 엔진 도메인을 자동으로 선택합니다
그러나 이 필드에서 사용자 지정 검색 엔진 도메인을 설정할 수 있습니다
예:
google.co.uk,google.com.au,google.de등. - search유형: string | null
_param 검색 쿼리의 추가 매개변수
선택 필드
사용 가능한 매개변수 목록과 자세한 내용은 여기에서 확인하세요
참고: 다음 검색 엔진 매개변수는 지원되지 않으며 지정하면 자동으로 해제됩니다:lr,cr,as_qdr,as_sitesearch,as_occt,as_filetype. - stop유형: array (object | null)[] | null
_crawl _on _match 크롤링을 중지할 대상 배열 선택 필드 지정하면 응답에 지정한 match_value까지 포함한 SERP 결과가 포함됩니다; 이 배열에는 대상 값을 최대 10개까지 지정할 수 있습니다 예: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] 이 매개변수에 대한 자세한 내용은 Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api 에서 확인하세요 지정한 대상을 통해 크롤링된 각 SERP마다 계정에 요금이 청구됩니다
- match유형: string | null
_type 대상 일치 유형 stop_crawl_on_match를 지정하면 필수 필드입니다; match_value의 일치 유형 가능한 값: domain, with_subdomains, wildcard
- match유형: string | null
_value 대상 도메인 또는 와일드카드 값 stop_crawl_on_match를 지정하면 필수 필드입니다; 대상 도메인 또는 와일드카드 값을 지정하세요; 참고: 도메인 이름은 요청 프로토콜 없이 지정해야 합니다; 예: dataforseo.com
- tag유형: string | null
사용자 정의 작업 식별자
선택 필드
최대 255자
이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다
지정한
tag값은 응답의data객체에서 확인할 수 있습니다 - target유형: string | null
_search _mode 대상 일치 모드
선택 필드
이 매개변수를 사용하려면
stop_crawl_on_match도 활성화해야 합니다stop_crawl_on_match에 여러 대상이 지정된 경우 크롤을 중지하는 방법을 정의합니다가능한 값:
all,anyall– 지정한 모든 대상을 찾았을 때만 크롤을 중지합니다any– 단일 대상이라도 찾으면 크롤을 중지합니다기본값:
any이 매개변수에 대한 자세한 내용은 Help Center에서 확인하세요
- url유형: string | null
검색 쿼리의 직접 URL
선택 필드
직접 URL을 지정하면 필요한 필드로 정리해 드립니다. 다만 이 방식은 API가 처리하기 가장 어려우며 URL에 정확한 언어와 위치를 지정해야 합니다. 대부분의 경우 이 방식은 권장하지 않습니다.
예:
https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
참고: 다음 검색 엔진 매개변수는 지원되지 않으며 URL에 지정하면 자동으로 해제됩니다:lr,cr,as_qdr,as_sitesearch,as_occt,as_filetype.
- 유형: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveHtmlResponseInfo200
- 유형: number | null 형식: doublecost
전체 작업 비용, USD
- 유형: integer | nullstatus
_code 일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: string | nullstatus
_message 일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: array (object | null)[] | nulltasks
작업 배열
- 유형: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveHtmlTaskInfo
- cost유형: number | null 형식: double
전체 작업 비용, USD
- data유형: object | null
POST 요청에 지정한 것과 동일한 매개변수를 포함합니다
- property유형: object | null
Name
- id유형: string | null
작업 식별자 시스템 내 고유 작업 식별자(UUID 형식)
- path유형: array (string | null)[] | null
URL 경로
- result유형: array (object | null)[] | null
결과 배열
- datetime유형: string | null
결과를 받은 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:2019-11-15 12:57:46 +00:00 - items유형: array (object | null)[] | null
SERP에서 발견된 검색 결과 요소
- date유형: string | null
HTML 페이지가 스캔된 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:2019-11-15 12:57:46 +00:00 - html유형: string | null
HTML 페이지
- page유형: integer | null
반환된 HTML 페이지의 일련번호
- items유형: integer | null 형식: int64
_count items배열에서 반환된 결과 수 - keyword유형: string | null
POST 배열에서 수신한 키워드
키워드는 %##이 디코딩된 상태로 반환됩니다('+' 문자는 공백 문자로 디코딩됨) - language유형: string | null
_code POST 배열의 언어 코드
- location유형: integer | null
_code POST 배열의 위치 코드
- se유형: string | null
_domain POST 배열의 검색 엔진 도메인
- type유형: string | null
요소 유형
- result유형: integer | null 형식: int64
_count result 배열의 요소 수
- status유형: integer | null
_code 작업의 상태 코드 DataForSEO가 생성하며 10000-60000 범위일 수 있습니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- status유형: string | null
_message 작업의 정보 메시지 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- time유형: string | null
실행 시간, 초
- 유형: integer | null 형식: int64tasks
_count tasks 배열의 작업 수
- 유형: integer | null 형식: int64tasks
_error 오류와 함께 반환된 tasks 배열의 작업 수
- 유형: string | nulltime
총 실행 시간(초)
- 유형: string | nullversion
API의 현재 버전
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/html \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"page": null,
"date": null,
"html": null
}
]
}
]
}
]
}