DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
실시간 OnPage Lighthouse JSON
하나의 url에서 Google Lighthouse 감사를 실행하고 전체 보고서를 반환합니다. 보고서에는 lighthouseVersion, requestedUrl, finalUrl, fetchTime, gatherMode, runWarnings와 모든 감사 및 카테고리 점수가 포함됩니다. for_mobile은 에뮬레이션할 기기를 전환하고, categories와 audits는 실행 범위를 좁힙니다. categories 또는 audits를 전달해 보고서를 줄이고, 단순히 페이지가 느린 이유를 알고 싶다면 post_dataforseo_on_page_waterfall을 사용하세요. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result, 처리 결과는 tasks[0].status_code에 있으며, 거부된 요청도 HTTP 200을 반환합니다.
가격 참고
- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.005.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: array (object | null)[]
- audits유형: array string[] | null
Lighthouse 감사
선택 필드
감사는 Lighthouse가 각 기능/최적화/지표에 대해 실행하여 숫자 점수를 산출하는 개별 테스트입니다(공식 정의 참조);이 필드를 무시하면 모든 감사에 대한 데이터를 반환합니다;
이 필드를 사용하면 여기에 지정한 특정 감사에 대한 데이터를 얻을 수 있습니다;참고: 일부 감사는 특정 카테고리에 속하지 않으며 독립형 페이지 품질 측정값입니다;
일반적으로 몇 가지 사용 사례가 있습니다:
1.
categories를 무시하면 이 필드를 사용하여 지정한 감사에 대한 데이터만 얻을 수 있습니다
예를 들어"categories"를 무시하고"audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"]을 지정하면 해당 감사에 대한 데이터만 얻게 됩니다2. 카테고리를 지정하면 이 필드를 사용하여 지정한 카테고리에 속하지 않는 감사를 추가로 받을 수 있습니다
예를 들어"categories": ["seo"]와"audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"]를 지정하면 "performance" 아래의 해당 감사만, "seo" 아래의 모든 감사를 얻게 됩니다 - browser유형: number | null
_cpu _throttling _multiplier 브라우저 CPU 스로틀링 배수
browser_network_throttling_method가devtools로 설정된 경우 필수입니다;
Lighthouse 감사 중 기기 성능 조건을 시뮬레이션하도록 CPU 스로틀링 배수를 설정하세요;
다음 범위 내에서 지정할 수 있습니다:1–4;
참고: 이 매개변수는browser_network_throttling_method가devtools로 설정된 경우에만 적용됩니다; - browser유형: string | null
_network _throttling 브라우저 네트워크 스로틀링
browser_network_throttling_method가devtools로 설정된 경우 필수입니다;
Lighthouse 감사 중 연결 속도 조건을 시뮬레이션하도록 네트워크 스로틀링 프로필을 설정하세요;
가능한 값:no_throttling,fast_4g,slow_4g,regular_3g,pc;
참고: 이 매개변수는browser_network_throttling_method가devtools로 설정된 경우에만 적용됩니다; - browser유형: string | null
_network _throttling _method 브라우저 네트워크 스로틀링 방법
선택 필드
Lighthouse 감사 중 스로틀링을 적용하는 데 사용되는 방법을 정의합니다;
가능한 값:simulate- 명시적 스로틀링을 적용하지 않고 예상 성능 지표를 계산합니다;devtools-browser_network_throttling및browser_cpu_throttling_multiplier에 지정된 스로틀링 설정을 적용합니다;provided- 크롤링 환경의 네트워크 조건을 사용합니다; - browser유형: integer | null
_screen _height 브라우저 화면 높이
선택 필드
특정 기기를 에뮬레이션하도록 Lighthouse 감사에 사용되는 브라우저의 화면 높이를 설정하세요;
다음 범위 내에서 지정할 수 있습니다:240–9999; - browser유형: number | null
_screen _scale _factor 브라우저 화면 배율
선택 필드
Lighthouse 감사에 사용되는 브라우저의 기기 픽셀 비율을 설정하세요;
다음 범위 내에서 지정할 수 있습니다:0.5–3; - browser유형: integer | null 형식: int64
_screen _width 브라우저 화면 너비
선택 필드
특정 기기를 에뮬레이션하도록 Lighthouse 감사에 사용되는 브라우저의 화면 너비를 설정하세요;
다음 범위 내에서 지정할 수 있습니다:240–9999; - categories유형: array string[] | null
- custom유형: string | null
_user _agent 사용자 지정 User-Agent
선택 필드
Lighthouse 감사를 실행할 때 브라우저가 사용하는 사용자 지정 User-Agent를 지정하세요;
최대 254자까지 지정할 수 있습니다; - for유형: boolean | null
_mobile 모바일 에뮬레이션 적용
선택 필드true로 설정하면 Lighthouse가 모바일 기기 및 화면 에뮬레이션을 사용하여 모바일 환경에서 페이지를 테스트합니다false로 설정하면 데스크톱에 대한 결과가 제공됩니다
기본값:false - language유형: string | null
_code Lighthouse 언어 코드
선택 필드https://api.dataforseo.com/v3/on_page/lighthouse/languages에 별도 요청을 보내language_code와 함께 검색 엔진에서 사용 가능한 언어 목록을 받을 수 있습니다
기본값:en - language유형: string | null
_name Lighthouse 언어 이름
선택 필드https://api.dataforseo.com/v3/on_page/lighthouse/languages에 별도 요청을 보내language_name과 함께 검색 엔진에서 사용 가능한 언어 목록을 받을 수 있습니다
기본값:English - tag유형: string | null
사용자 정의 작업 식별자
선택 필드
최대 255자
이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다tag에 지정한 값은 응답의data객체에서 확인할 수 있습니다 - url유형: string
대상 URL
필수 필드
대상 페이지는 절대 URL(http:// 또는 https:// 포함)로 지정해야 합니다
예:https://dataforseo.com/ - version유형: string | null
- 유형: object | null · Response36Afe1097B20_OnPageLighthouseLiveJsonResponseInfo200
- 유형: number | null 형식: doublecost
전체 작업 비용, USD
- 유형: integer | nullstatus
_code 일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: string | nullstatus
_message 일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: array (object | null)[] | nulltasks
작업 배열
- 유형: object | null · Response36Afe1097B20_OnPageLighthouseLiveJsonTaskInfo
- 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
Lighthouse 감사 결과
이 배열은 작업을 설정할 때 지정한 매개변수에 따른 데이터를 포함합니다;모든 필드와 설명은 이 링크의 공식 문서에서 확인할 수 있습니다
- property유형: object | null
Name
- 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/lighthouse/live/json \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"url": "https://dataforseo.com",
"for_mobile": true,
"tag": "some_string_123"
}
]'
{
"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": [
null
]
}
]
}