# On-page content parsing

This endpoint allows parsing the content on any page you specify and will return the structured content of the target page, including link URLs, anchors. Needs url. Served by DataForSEO.

This endpoint allows parsing the content on any page you specify and will return the structured content of the target page, including link URLs, anchors, headings, and textual content.

- Tool ID: `dataforseo/on-page-content-parsing`
- Name in the catalog: On Page Content Parsing
- 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/content_parsing_live; 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": "URL of the content to parse required field URL of the page to parse example: `https://www.fujielectric.com/`",
      "maxLength": 2000,
      "minLength": 1
    },
    "browser_preset": {
      "type": "string",
      "description": "preset for browser screen parameters optional field if you use this field, you don't need to indicate browser_screen_width, browser_screen_height, browser_screen_scale_factor possible values: desktop, mobile, tablet desktop preset will appl",
      "maxLength": 2000,
      "minLength": 1
    },
    "browser_screen_width": {
      "type": "integer",
      "description": "browser screen width optional field you 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"
    },
    "browser_screen_height": {
      "type": "integer",
      "description": "browser screen height optional field you 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, s"
    },
    "browser_screen_scale_factor": {
      "type": "number",
      "description": "browser screen scale factor optional field you 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 t",
      "minimum": 0.5,
      "maximum": 3
    },
    "store_raw_html": {
      "type": "boolean",
      "description": "store HTML of a crawled page optional field set to true if you want to get the HTML of the page using the OnPage Raw HTML endpoint default value: false"
    },
    "disable_cookie_popup": {
      "type": "boolean",
      "description": "disable the cookie popup optional field set to true if you want to disable the popup requesting cookie consent from the user; default value: false"
    },
    "accept_language": {
      "type": "string",
      "description": "language header for accessing the website optional field all 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 \"ty",
      "maxLength": 2000,
      "minLength": 1
    },
    "switch_pool": {
      "type": "boolean",
      "description": "switch proxy pool optional field if 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 "
    },
    "ip_pool_for_scan": {
      "type": "string",
      "description": "proxy pool optional field you 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_unreachabl",
      "maxLength": 2000,
      "minLength": 1
    },
    "markdown_view": {
      "type": "boolean",
      "description": "return page content as markdown optional field if set to true, the markdown-formatted content of the page will be returned in the page_as_markdown field of the response; default value: false"
    }
  },
  "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-content-parsing",
  "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/content_parsing/live/)

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

---

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