# Olostep Web Page Scrape via x402.orthogonal.com

> Olostep Web Page Scrape via x402.orthogonal.com is a paid API for AI agents from x402.orthogonal.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Initiates a web page scrape using Olostep, returning page content in configurable formats with optional HTML transformation, structured data extraction, and geo-targeted residential proxies

## Facts

- Endpoint: POST https://x402.orthogonal.com/olostep/v1/scrapes
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/olostep-web-page-scrape-via-x402-orthogonal-com-88681185
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l5qRB3e0WOS_xK-sUElK1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability olostep-web-page-scrape-via-x402-orthogonal-com-88681185 -d '<json body>'
```

Example prompt: Scrape the page at https://example.com/article for me and return the content as markdown, removing ads using the Postlight transformer, loading from a US residential IP on desktop screen size.

## When to prefer this

Choose this endpoint when you need to scrape a single URL with fine-grained control over output format, residential proxy country, screen size, HTML transformation (ad removal via Postlight), structured data extraction via a parser or LLM schema, and link filtering. It is particularly well-suited for geo-sensitive scraping (e.g. price comparison across regions) and for extracting clean, readable article content. Prefer it over raw HTTP fetching when you need residential IP rotation, JavaScript-rendered page support, or built-in content cleaning.

## Known failure modes

- Target URL is unreachable or returns a non-200 HTTP status
- Country value is unsupported or misspelled, causing a 400 error
- Requested parser ID does not exist or is misconfigured
- Page requires JavaScript rendering not supported by the action config
- LLM extraction schema is malformed or too complex
- Payment of $0.01 USDC fails or x402 payment header is missing/invalid
- Scrape times out due to slow target server
- Anti-bot detection on target site blocks the request

## How this service works

Initiate a web page scrape

## Output

Returns the scraped page content in the requested format(s) — e.g. raw HTML, markdown, or structured JSON — along with optional extracted links, LLM-extracted structured fields, and metadata about the scrape. The response format depends on which 'formats' were requested and whether a parser or llm_extract schema was provided.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "parser": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string"
    }
   },
   "description": "When defining json as a format, you can use this parameter to specify the parser to use. Parsers are useful to extract structured content from web pages. Olostep has a few parsers built in for most common web pages, and you can also create your own parsers."
  },
  "actions": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "milliseconds": {
     "type": "number"
    }
   },
   "description": "Actions to perform on the page before getting the content."
  },
  "country": {
   "type": "string",
   "description": "Residential country to load the request from. Supported values are: * US (United States) * CA (Canada) * IT (Italy) * IN (India) * GB (England) * JP (Japan) * MX (Mexico) * AU (Australia) * ID (Indonesia) * UA (UAE) * RU (Russia) * RANDOM Some operations, like scraping Google Search and Google News, support all countries."
  },
  "formats": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Formats in which you want the content."
  },
  "metadata": {
   "type": "object",
   "description": "User-defined metadata. Not supported yet"
  },
  "llm_extract": {
   "type": "object",
   "properties": {
    "schema": {
     "type": "object"
    }
   }
  },
  "screen_size": {
   "type": "object",
   "properties": {
    "screen_type": {
     "type": "string"
    },
    "screen_width": {
     "type": "number"
    },
    "screen_height": {
     "type": "number"
    }
   },
   "description": "Configuration for screen size. Preset dimensions are available through screen_type: desktop (1920x1080), mobile (414x896), or default (768x1024)."
  },
  "transformer": {
   "type": "string",
   "description": "Specify the HTML transformer to use, if any. Postlight's Mercury Parser library is used to remove ads and other unwanted content from the scraped content. Available options: `postlight`, `none`"
  },
  "links_on_page": {
   "type": "object",
   "properties": {
    "exclude_links": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "include_links": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "absolute_links": {
     "type": "boolean"
    },
    "query_to_order_links_by": {
     "type": "string"
    }
   },
   "description": "With this option, you can get all the links present on t
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/olostep-web-page-scrape-via-x402-orthogonal-com-88681185/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.orthogonal.com](https://www.zero.xyz/host/x402.orthogonal.com/llms.txt)