{"id":9834,"date":"2021-07-15T15:08:25","date_gmt":"2021-07-15T15:08:25","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=9834"},"modified":"2026-01-06T15:52:50","modified_gmt":"2026-01-06T15:52:50","slug":"on_page-lighthouse-overview","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/on_page-lighthouse-overview\/","title":{"rendered":"on_page\/lighthouse\/overview"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]<\/p>\n

OnPage Lighthouse API: Overview<\/h1>\n
\n \"checked\"\n\n The OnPage Lighthouse API is based on Google's open-source Lighthouse project and provides data on the quality of web pages. <\/div>\n \n

The OnPage Lighthouse API is a tool for leveraging the capabilities of Lighthouse – Google’s open-source project intended to help webmasters access the data on the performance and quality of web pages and web apps.<\/p>\n

Lighthouse reports the performance metrics simulating a mid-tier mobile device on a 4G internet connection. To achieve that, Lighthouse incorporates sophisticated architecture, illustrated below. You can get more information about how Lighthouse works by visiting the official documentation of Google’s Lighthouse project. <\/p>\n

\"\"<\/p>\n

Note that OnPage Lighthouse API is based on Google’s open-source Lighthouse project<\/a>. The data returned in the results<\/code> array of the API’s response is identical to that described in the project’s official documentation<\/a>. You can refer to it for more information about the content and structure of the data provided by OnPage Lighthouse API. <\/em><\/p>\n

Sending a web page for crawling is done through a POST request to the Lighthouse Task POST<\/a> endpoint. Alongside the URL of the web page, you can specify additional parameters, which would help you filter the data and get the results you need:<\/p>\n

● Audits<\/strong> contain the results of the audits and keyed by their titles; to get only certain audits, you should specify their titles in the corresponding Task POST array; you can obtain the list of titles of all available audits by requesting the Lighthouse Audits endpoint<\/a>.
\n● Categories<\/strong> contain different categories, their scores, and references to the audits that comprise them.<\/p>\n

After the website is fetched for crawling, you can start retrieving results by passing the task_id<\/code> of the tasks in the Lighthouse Task GET<\/a> endpoint. For now, you can obtain results in JSON only, but we plan to add support for HTML in the nearest future. <\/p>\n

Learn more about task completion and obtaining a list of completed tasks in this help center article.<\/a> <\/p>\n

\u200cAlternatively, you can specify pingback_url<\/code> or postback_url<\/code> when setting a task, and we will notify you on completion of tasks or send the results to you respectively. <\/p>\n

If you do use pingback_url<\/code> or postback_url<\/code>, you can receive the list of id for all completed tasks using the Tasks Ready<\/a> endpoint. It is designed to provide you with a list of completed tasks, which haven’t been collected yet. <\/p>\n

You can send up to 2000 API calls per minute, with each POST call containing no more than 100 tasks. Contact us if you would like to raise the limit. Note that the maximum number of simultaneous requests you can send is limited to 30.<\/p>\n

If your system requires delivering instant results, the Lighthouse Live<\/a> endpoint is the best solution for you as it doesn\u2019t require making separate POST and GET requests to the corresponding endpoints.<\/p>\n

You can test the Lighthouse OnPage API for free using DataForSEO Sandbox.<\/a><\/p>\n

The cost can be calculated on the Pricing<\/a> page or by making a separate call to the User Data endpoint.<\/a><\/strong><\/p>\n

[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n

Instead of \u2018login\u2019 and \u2018password\u2019 use your credentials from https:\/\/app.dataforseo.com\/api-access<\/p><\/blockquote><\/div>","protected":false},"excerpt":{"rendered":"

[vc_row][vc_column][vc_column_text] OnPage Lighthouse API: Overview The OnPage Lighthouse API is based on Google's open-source Lighthouse project and provides data on the quality of web pages. The OnPage Lighthouse API is a tool for leveraging the capabilities of Lighthouse – Google’s open-source project intended to help webmasters access the data on the performance and quality of […]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","footnotes":""},"class_list":["post-9834","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/9834","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=9834"}],"version-history":[{"count":14,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/9834\/revisions"}],"predecessor-version":[{"id":9851,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/9834\/revisions\/9851"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=9834"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}