DataForSEO

DataForSEO OnPage API

The OnPage API from DataForSEO — 30 operation(s) for onpage.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 30

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v3/on_page/id_list List On-Page task IDs for a time period · On page id list #
Ask an LLM
“Can I get the IDs of every site crawl task I created within a date range?”
“Does the On-Page task ID list include crawls that haven't finished?”
Tell an agent
List the IDs and metadata of all my On-Page crawl tasks from last week.
Pull the On-Page task ID list for last month, including incomplete crawls.
POST /v3/on_page/errors List On-Page tasks that failed recently · On page errors #
Ask an LLM
“Which of my site audit tasks returned errors in the past 7 days?”
“Where can I see why an On-Page crawl request failed?”
Tell an agent
Show On-Page tasks that errored in the last 7 days.
List recent site crawl task errors so I can debug them.
POST /v3/on_page/force_stop Force stop a running website crawl · Force stop #
Ask an LLM
“Can I stop a website crawl that's still running?”
“If I halt a crawl early, do I keep the data for pages already scanned?”
Tell an agent destructive · confirm first
Force stop the crawl for my site audit task now.
Halt these running On-Page crawl tasks and keep what was scanned.
GET /v3/on_page/available_filters List filters and thresholds for On-Page · On page available filters #
Ask an LLM
“What filters and performance thresholds can I use with On-Page audit results?”
“Which page check fields can I filter crawled pages by?”
Tell an agent
Show the filters and thresholds available for On-Page endpoints.
Get the list of On-Page filter fields.
POST /v3/on_page/task_post Start a website crawl and audit · Task post #
Ask an LLM
“How do I start an SEO audit that crawls my whole website?”
“Can a site crawl check meta tags, duplicate content, images and response codes on every page?”
Tell an agent
Start an On-Page crawl of my website with a 500-page limit.
Launch a full site audit for this domain and check 60+ on-page parameters.
GET /v3/on_page/tasks_ready List completed site crawl tasks · On page tasks ready #
Ask an LLM
“Which of my site crawls have finished but haven't been collected yet?”
“How do I know when an On-Page audit is ready to read?”
Tell an agent
List my completed On-Page crawl tasks awaiting collection.
Check which site audits are ready.
GET /v3/on_page/summary/{id} Get the audit summary of a crawled site · Summary #
Ask an LLM
“What's the overall health and list of issues for a site I crawled?”
“Can I see a crawl's progress and issue counts before drilling into details?”
Tell an agent
Get the On-Page summary for crawl task {id}.
Show the site issues overview for audit {id}.
POST /v3/on_page/pages List crawled pages with their checks · Pages #
Ask an LLM
“Which crawled pages failed on-page checks like missing titles or slow load?”
“Can I list every page from my audit with its optimization metrics?”
Tell an agent
List all crawled pages from my audit with their on-page check results.
Show pages from the crawl that are missing a meta description.
POST /v3/on_page/pages_by_resource Find pages that contain a resource · Pages by resource #
Ask an LLM
“Which pages on my site load a specific image or script?”
“Where is a broken resource used across my crawled pages?”
Tell an agent
Find every crawled page that uses this resource URL.
List the pages where this broken image appears.
POST /v3/on_page/resources List images, scripts and stylesheets found · Resources #
Ask an LLM
“What images, scripts and stylesheets did the crawler find on my site?”
“Are there broken resources on any of my crawled pages?”
Tell an agent
List all resources found in my site crawl, including broken ones.
Show the oversized images and scripts detected in the audit.
POST /v3/on_page/duplicate_tags Find pages with duplicate titles or descriptions · Duplicate tags #
Ask an LLM
“Which pages on my site share the same title tag?”
“Do any crawled pages have duplicate meta descriptions?”
Tell an agent
List pages with duplicate title tags from my crawl.
Find pages that reuse the same meta description.
POST /v3/on_page/duplicate_content Find pages with content similar to a page · Duplicate content #
Ask an LLM
“Which pages on my site have content too similar to a given page?”
“How similar is the near-duplicate content, as a similarity score?”
Tell an agent
Find pages whose content duplicates this URL from my crawl.
Show near-duplicate content pages with their similarity index.
POST /v3/on_page/redirect_chains Find redirect chains and loops · Redirect chains #
Ask an LLM
“Does my site have redirect chains with two or more hops?”
“Are any of my pages stuck in a redirect loop?”
Tell an agent
List the redirect chains found in my site crawl.
Find redirect loops across my crawled pages.
POST /v3/on_page/non_indexable List pages blocked from search indexing · Non indexable #
Ask an LLM
“Which pages are blocked from Google by robots.txt, headers or meta tags?”
“Why isn't a page on my site indexable?”
Tell an agent
List the non-indexable pages from my crawl and why they're blocked.
Show pages hidden from search engines by noindex or robots.txt.
POST /v3/on_page/waterfall Get page load timing waterfall · Waterfall #
Ask an LLM
“How long does each resource on my page take to load?”
“What's the connection and time-to-secure-connection breakdown for a crawled page?”
Tell an agent
Show the page speed waterfall for this URL from my crawl.
Break down load timing for every resource on this page.
POST /v3/on_page/keyword_density Get keyword density for a site or page · Keyword density #
Ask an LLM
“Which terms appear most often on my website or a specific page?”
“What's the keyword density and frequency of phrases on my crawled pages?”
Tell an agent
Show keyword density and frequency for my crawled site.
Get the most frequent two-word phrases on this page.
POST /v3/on_page/microdata Validate structured data on a page · Microdata #
Ask an LLM
“Is the JSON-LD and Microdata on my page valid?”
“What structured data errors did the crawler find on a page?”
Tell an agent
Validate the JSON-LD and Microdata on this crawled page.
Show structured data validation results for this URL.
POST /v3/on_page/raw_html Get the stored HTML of a crawled page · Raw html #
Ask an LLM
“Can I see the HTML the crawler stored for a page in my audit?”
“What source code did the site crawl capture for a URL?”
Tell an agent
Return the raw HTML of this page from my crawl.
Get the crawled HTML source for this URL.
POST /v3/on_page/page_screenshot Capture a full-page screenshot · Page screenshot #
Ask an LLM
“Can I see a screenshot of a page the way Googlebot sees it?”
“How do I capture a full high-quality screenshot of any webpage?”
Tell an agent
Take a full-page screenshot of this URL.
Capture how my homepage looks to the crawler.
POST /v3/on_page/content_parsing Parse content of a crawled page · Content parsing #
Ask an LLM
“Can I extract the headings, links and text of a page from my site crawl?”
“What structured content did the audit parse from a crawled URL?”
Tell an agent
Parse the structured content of this page from my existing crawl.
Extract headings and anchors from a crawled page in my audit.
POST /v3/on_page/content_parsing/live Parse any page's content live · Content parsing live #
Ask an LLM
“Can I extract the headings, links and text of any URL instantly without a crawl task?”
“Is there a real-time way to turn a webpage into structured content?”
Tell an agent
Parse this URL's content live and return headings, links and text.
Extract structured content from any page right now, no crawl needed.
POST /v3/on_page/instant_pages Audit a single page instantly · Instant pages #
Ask an LLM
“How well is a single page optimized for organic search, checked instantly?”
“Can I get on-page SEO data for one URL without crawling the whole site?”
Tell an agent
Run an instant on-page SEO check on this single URL.
Audit just this landing page for optimization issues.
GET /v3/on_page/lighthouse/languages List languages for Lighthouse reports · Lighthouse languages #
Ask an LLM
“In which languages can Lighthouse audit reports be returned?”
“Can I get a Lighthouse report localized to my language?”
Tell an agent
List the languages supported for Lighthouse audits.
Get the Lighthouse report language codes.
GET /v3/on_page/lighthouse/audits List available Lighthouse audits · Lighthouse audits #
Ask an LLM
“Which individual Lighthouse audits can I request?”
“What audit names can I include in a Lighthouse check?”
Tell an agent
List all available Lighthouse audits.
Show the Lighthouse audit names I can select.
GET /v3/on_page/lighthouse/versions List supported Lighthouse versions · Lighthouse versions #
Ask an LLM
“Which Lighthouse versions are available for page quality audits?”
“Can I pin my audit to a specific Lighthouse version?”
Tell an agent
List the supported Lighthouse versions.
Get the Lighthouse versions I can run audits with.
POST /v3/on_page/lighthouse/task_post Queue a Lighthouse audit of a page · Lighthouse task post #
Ask an LLM
“How do I queue a Lighthouse audit for a URL and fetch it later?”
“Can I submit a background Lighthouse performance and accessibility check?”
Tell an agent
Queue a Lighthouse audit for my homepage.
Submit a background Lighthouse task for this URL on mobile.
GET /v3/on_page/lighthouse/tasks_ready List completed Lighthouse tasks · Lighthouse tasks ready #
Ask an LLM
“Which Lighthouse audits I queued are finished but not yet collected?”
“How can I find ready Lighthouse results without a postback URL?”
Tell an agent
List my completed Lighthouse tasks waiting to be collected.
Check which Lighthouse audits are ready.
GET /v3/on_page/lighthouse/task_get/json/{id} Get results of a queued Lighthouse audit · Lighthouse task get json #
Ask an LLM
“How do I retrieve the Lighthouse report for an audit I queued?”
“Does a queued Lighthouse result include performance, accessibility and SEO scores?”
Tell an agent
Get the Lighthouse JSON results for task {id}.
Fetch performance and SEO scores from Lighthouse audit {id}.
POST /v3/on_page/lighthouse/live/json Run a live Lighthouse audit · Lighthouse live json #
Ask an LLM
“Can I run a Lighthouse audit on a page and get the results immediately?”
“What are my page's Lighthouse scores right now, without queuing a task?”
Tell an agent
Run a live Lighthouse audit on this URL and return JSON.
Get real-time Lighthouse scores for my landing page.

Documentation

📖
Documentation
https://docs.dataforseo.com/v3/on_page/overview/
📖
APIReference
https://docs.dataforseo.com/v3/on_page/overview/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-onpage-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/json-schema/dataforseo-on-page-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/overlays/dataforseo-onpage-overlay.yaml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/examples/dataforseo-on-page-examples.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dataforseo:dataforseo-onpage-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dataforseo-onpage-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: DataForSEO On Page API
  description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
  version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:


# --- truncated at 32 KB (241 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-onpage-api-openapi.yml