# On-page instant pages

Using this function you will get page-specific data with detailed information on how well a particular page is optimized for organic search. Needs url. Served by DataForSEO.

Using this function you will get page-specific data with detailed information on how well a particular page is optimized for organic search. for more info please visit 'https://docs.dataforseo.com/v3/on_page/instant_pages/?bash'

- Tool ID: `dataforseo/on-page-instant-pages`
- Name in the catalog: On Page Instant Pages
- Provider: [DataForSEO](/providers/dataforseo.md)
- Capability: [Site audit (on-page)](/tools/seo/site-audit.md)
- Price: usage based, the maximum is shown before a run
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

Billed at the cost the provider reports for the call, never above $100. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "cost",
  "maxUsdDefault": 0.00015,
  "maxUsdCap": 100,
  "requireCost": true
}
```

Pricing source: [https://docs.dataforseo.com/v3/appendix/user_data/](https://docs.dataforseo.com/v3/appendix/user_data/). Account tariff on_page/instant_pages; bounds applied to inputs; actual cost from provider response..

Price verification date: 2026-10-10.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "target page urlrequired fieldabsolute URL of the target page;Note #1: results will be returned for the specified URL only;Note #2: to prevent denial-of-service events, tasks that contain a duplicate crawl host will be returned with a 40501 ",
      "maxLength": 2000,
      "minLength": 1
    },
    "browser_preset": {
      "type": "string",
      "description": "preset for browser screen parametersoptional fieldif you use this field, you don't need to indicate browser_screen_width, browser_screen_height, browser_screen_scale_factorpossible values:desktop, mobile, tabletdesktop preset will apply the",
      "maxLength": 2000,
      "minLength": 1
    },
    "browser_screen_width": {
      "type": "integer",
      "description": "browser screen widthoptional fieldyou can set a custom browser screen width to perform audit for a particular device;if you use this field, you don't need to indicate browser_preset as it will be ignored;Note: to use this parameter, set ena"
    },
    "browser_screen_height": {
      "type": "integer",
      "description": "browser screen heightoptional fieldyou can set a custom browser screen height to perform audit for a particular device;if you use this field, you don't need to indicate browser_preset as it will be ignored;Note: to use this parameter, set e"
    },
    "browser_screen_scale_factor": {
      "type": "number",
      "description": "browser screen scale factoroptional fieldyou can set a custom browser screen resolution ratio to perform audit for a particular device;if you use this field, you don't need to indicate browser_preset as it will be ignored;Note: to use this "
    },
    "store_raw_html": {
      "type": "boolean",
      "description": "store HTML of a crawled pageoptional fieldset to true if you want get the HTML of the page using the OnPage Raw HTML endpointdefault value: false"
    },
    "accept_language": {
      "type": "string",
      "description": "language header for accessing the websiteoptional fieldall locale formats are supported (xx, xx-XX, xxx-XX, etc.)Note: if you do not specify this parameter, some websites may deny access; in this case, pages will be returned with the \"type\"",
      "maxLength": 2000,
      "minLength": 1
    },
    "disable_cookie_popup": {
      "type": "boolean",
      "description": "disable the cookie popup optional fieldset to true if you want to disable the popup requesting cookie consent from the user;default value:false"
    },
    "return_despite_timeout": {
      "type": "boolean",
      "description": "return data on pages despite the timeout erroroptional fieldif true, the data will be provided on pages that failed to load within 120 seconds and responded with a timeout error;default value: false"
    },
    "validate_micromarkup": {
      "type": "boolean",
      "description": "enable microdata validationoptional fieldif set to true, you can use the OnPage API Microdata endpoint with the id of the task;default value: false"
    },
    "checks_threshold": {
      "type": "object",
      "description": "custom threshold values for checksoptional fieldyou can specify custom threshold values for the parameters included in the checks array of OnPage API responses;Note: only integer threshold values can be modified;",
      "properties": {},
      "additionalProperties": {
        "type": "integer"
      }
    },
    "switch_pool": {
      "type": "boolean",
      "description": "switch proxy pooloptional fieldif true, additional proxy pools will be used to obtain the requested data;the parameter can be used if a multitude of tasks is set simultaneously, resulting in occasional rate-limit and/or site_unreachable err"
    },
    "ip_pool_for_scan": {
      "type": "string",
      "description": "proxy pooloptional fieldyou can choose a location of the proxy pool that will be used to obtain the requested data;the parameter can be used if page content is inaccessible in one of the locations, resulting in occasional site_unreachable e",
      "maxLength": 2000,
      "minLength": 1
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "dataforseo/on-page-instant-pages",
  "input": {
    "url": "https://example.com/"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://docs.dataforseo.com/v3/on_page/instant_pages/)

[REST inspection](https://api.agentik.cc/v1/tools/dataforseo/on-page-instant-pages) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/dataforseo/on-page-instant-pages) · [Agent index](/llms.txt)