DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API 요약
id로 크롤링 하나의 상태와 주요 지표를 조회합니다. crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info, page_metrics를 반환합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result, 처리 결과는 tasks[0].status_code에 있으며, 거부된 요청도 HTTP 200을 반환합니다. 크롤링 완료 여부도 이 엔드포인트로 확인합니다. 여기서 다른 엔드포인트를 읽기 전에 crawl_progress가 finished가 될 때까지 폴링하세요. 그렇지 않으면 실제 결과처럼 보이는 부분 결과를 읽게 됩니다. 💰 업스트림 무료: 완료된 크롤링 조회에는 비용이 들지 않으며, 크롤링 자체에만 비용이 발생합니다.
가격 참고
- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.012.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo200
- 유형: number | null 형식: doublecost
전체 작업 비용, USD
- 유형: integer | nullstatus
_code 일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: string | nullstatus
_message 일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: array (object | null)[] | nulltasks
작업 배열
- 유형: object | null · Response36Afe1097B20_OnPageSummaryTaskInfo
- 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
결과 배열
- crawl유형: string | null
_gateway _address - crawl유형: string | null
_progress 크롤링 세션 상태
가능한 값:in_progress,finished - crawl유형: object | null · Response36Afe1097B20_CrawlStatusInfo
_status 크롤링 세션 세부 정보
- max유형: integer | null 형식: int64
_crawl _pages 크롤링할 최대 페이지 수 작업을 설정할 때 지정한 max_crawl_pages 한도를 나타냅니다
- pages유형: integer | null 형식: int64
_crawled 크롤링된 페이지 수
- pages유형: integer | null 형식: int64
_in _queue 현재 크롤링 대기열에 있는 페이지 수
- crawl유형: string | null
_stop _reason - domain유형: object | null · Response36Afe1097B20_DomainInfo
_info 도메인 전체 정보
대상 도메인과 크롤링 프로세스에 대한 페이지 내 정보- canonicalization유형: integer | null
_status _code 정규화된 페이지에서 반환된 상태 코드
크롤러가 IP를 통해 웹사이트에 액세스하려 할 때의 서버 동작 검사;
대부분의 경우 정규화된 페이지는301또는302상태 코드로 응답하는 것이 권장됩니다 - checks유형: object | null
웹사이트 검사
웹사이트와 관련된 기타 온페이지 검사- property유형: boolean | null
Name
- cms유형: string | null
콘텐츠 관리 시스템
웹사이트에서 식별된 콘텐츠 관리 시스템generator메타 태그의 콘텐츠
데이터는 200 응답 코드를 반환하는 첫 번째 무작위 페이지에서 가져옵니다
크롤러가 CMS를 식별할 수 없으면 값은null입니다 - crawl유형: string | null
_end 크롤링이 종료된 시간
크롤링이 완료된 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:2019-11-15 12:57:46 +00:00
참고:"crawl_progress"가"finished"인 경우에만 유효합니다"crawl_progress"가in_progress이면 값은null입니다 - crawl유형: string | null
_start 크롤링이 시작된 시간
웹사이트가 크롤링을 위해 전송된 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:2019-11-15 12:57:46 +00:00 - directory유형: integer | null
_browsing _status _code 디렉터리에서 반환된 상태 코드
대상 웹사이트의 디렉터리 페이지에서 반환된 상태 코드
대부분의 경우 디렉터리는403또는401상태 코드로 응답하는 것이 권장됩니다 - extended유형: string | null
_crawl _status 크롤링 상태 및 오류
웹사이트가 크롤링되지 않은 이유를 나타냅니다;
가능한 값:no_errors- 크롤링 오류가 감지되지 않았습니다;site_unreachable- 크롤러가 웹사이트에 연결할 수 없어 상태 코드를 가져올 수 없었습니다;invalid_page_status_code- 처음 크롤링한 페이지의 상태 코드가 400 이상입니다;forbidden_meta_tag- 처음 크롤링한 페이지에 <meta robots="noindex"> 태그가 있습니다;forbidden_robots- robots.txt가 페이지 크롤링을 금지합니다;forbidden_http_header- 페이지의 HTTP 헤더에 "X-Robots-Tag: noindex"가 있습니다;too_many_redirects- 처음 크롤링한 페이지의 리디렉션이 10개를 초과합니다;unknown- 이유를 알 수 없습니다 - ip유형: string | null
도메인 IP 주소
- main유형: string | null
_domain 루트 도메인 이름
- name유형: string | null
도메인 이름
- page유형: integer | null
_not _found _status _code 존재하지 않는 페이지에서 반환된 상태 코드
대부분의 경우 서버는 404 응답 코드를 반환하는 것이 권장됩니다 - server유형: string | null
웹사이트 서버
웹사이트에서 감지된 서버 버전server헤더의 콘텐츠
정보는 응답 코드가 200인 첫 번째 페이지에서 가져옵니다 - ssl유형: object | null · Response36Afe1097B20_SslInfo
_info SSL 인증서 정보
웹사이트에서 감지된 Secure Sockets Layer 프로토콜에 관한 정보- certificate유형: string | null
_expiration _date SSL 인증서 만료일
SSL 인증서가 만료되는 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:2019-11-15 12:57:46 +00:00 - certificate유형: string | null
_hash SSL 인증서 해시
SSL 인증서 해시 함수의 버전 - certificate유형: string | null
_issuer SSL 인증서 발급 기관
감지된 SSL 인증서를 발급한 주체 - certificate유형: string | null
_subject SSL 인증서 주체
공개 키와 연결된 주체 - certificate유형: integer | null
_version - valid유형: boolean | null
_certificate SSL 인증서 유효성
웹사이트에서 감지된 SSL 인증서가 만료, 일시 중단, 폐기 또는 무효 상태가 아닌지 나타냅니다
- total유형: integer | null 형식: int64
_pages 총 크롤링 페이지 수
크롤링된 총 페이지 수 - total유형: integer | null 형식: int64
_uncrawlable _resources 크롤링할 수 없는 총 리소스 수
크롤링할 수 없었던 총 리소스 수;
리소스의 실제 콘텐츠 유형이 크롤러가 기대하는 콘텐츠 유형과 일치하지 않으면 크롤링할 수 없는 것으로 간주됩니다 - www유형: integer | null
_redirect _status _code 리디렉션 상태 코드
www에서 비www로의 리디렉션 상태 코드
대부분의 경우 리디렉션은301상태 코드를 반환하는 것이 권장됩니다
- page유형: object | null · Response36Afe1097B20_PageMetrics
_metrics 페이지별 정보
대상 웹사이트 페이지의 지표 정보- broken유형: integer | null
_links 깨진 링크 수
대상 웹사이트에서 크롤링된 모든 페이지의 깨진 링크 수 - broken유형: integer | null
_resources 깨진 리소스 수
링크가 깨진 이미지 및 기타 리소스의 수 - checks유형: object | null
페이지별 페이지 내 점검
- property유형: integer | null 형식: int64
Name Signed 64-bit integers (long type).
- duplicate유형: integer | null
_content 중복 콘텐츠가 있는 페이지 수
- duplicate유형: integer | null
_description 중복 설명이 있는 페이지 수
- duplicate유형: integer | null
_title 중복 제목이 있는 페이지 수
- links유형: integer | null
_external 외부 링크 수
다른 웹사이트를 가리키는 링크 수 - links유형: integer | null
_internal 내부 링크 수
대상 웹사이트 내 다른 페이지를 가리키는 링크 수 - links유형: integer | null
_relation _conflict 대상 웹사이트에서 충돌 가능성이 있는 링크 수
예를 들어"links_relation_conflict": 2이면 대상 웹사이트가rel="nofollow"속성이 있는 내부 링크 와 dofollow 링크를 통해 동일한 소스를 하나 이상 참조하고 있음을 의미합니다 - non유형: integer | null
_indexable - onpage유형: number | null
_score - redirect유형: integer | null
_loop 동일한 URL에서 시작하고 끝나는 리디렉션 체인 수
대상 URL이 원래 URL로 다시 리디렉션되는 리디렉션 체인 수
- 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/on_page/summary/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"crawl_gateway_address": null,
"crawl_stop_reason": null,
"domain_info": {
"name": null,
"cms": null,
"ip": null,
"server": null,
"crawl_start": null,
"crawl_end": null,
"extended_crawl_status": null,
"ssl_info": "[Max Depth Exceeded]",
"checks": null,
"total_pages": null,
"total_uncrawlable_resources": null,
"page_not_found_status_code": null,
"canonicalization_status_code": null,
"directory_browsing_status_code": null,
"www_redirect_status_code": null,
"main_domain": null
},
"page_metrics": {
"links_external": null,
"links_internal": null,
"duplicate_title": null,
"duplicate_description": null,
"duplicate_content": null,
"broken_links": null,
"broken_resources": null,
"links_relation_conflict": null,
"redirect_loop": null,
"onpage_score": null,
"non_indexable": null,
"checks": null
}
}
]
}
]
}