# Olostep Website URL Mapper

> Olostep Website URL Mapper 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-15).

Crawls a website and returns all discoverable URLs, with optional filtering, search relevance sorting, and cursor-based pagination for large sites

## Facts

- Endpoint: POST https://x402.orthogonal.com/olostep/v1/maps
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/olostep-website-url-mapper-f9a82414
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bmomrMwpoJhb-UvmnbaDq

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-website-url-mapper-f9a82414 -d '<json body>'
```

Example prompt: Can you give me all the URLs on docs.example.com, only including pages under /api/ and excluding anything under /api/legacy/, and sort them by relevance to 'authentication'?

## When to prefer this

Use this endpoint when you need to discover all or a filtered subset of URLs on a website without manually crawling each page — ideal for sitemap generation, content audits, SEO analysis, or building a scraping pipeline. Prefer this over a raw scraper when you need structured URL enumeration rather than page content. The search_query parameter makes it especially useful when you want URLs ranked by topical relevance rather than raw crawl order.

## Known failure modes

- Timeout for extremely large or complex websites exceeding 120 seconds
- Invalid or unreachable URL returns an error
- Malformed glob patterns in include_urls or exclude_urls may produce unexpected results
- Cursor from a previous request that has expired or is invalid returns an error
- Rate limiting or bot protection on the target site may result in incomplete URL discovery

## How this service works

This endpoint allows users to get all the urls on a certain website. It can take up to 120 seconds for complex websites. For large websites, results are paginated using cursor-based pagination

## Output

A paginated list of URLs discovered on the target website, optionally filtered by include/exclude glob patterns and sorted by search relevance. The response includes a pagination cursor that can be used to fetch the next batch of URLs if the site is large. May take up to 120 seconds for complex sites.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "The URL of the website for which you want the links"
  },
  "top_n": {
   "type": "number",
   "description": "An optional number to limit to only top n links for a search query."
  },
  "cursor": {
   "type": "string",
   "description": "OPTIONAL: Pagination cursor from a previous response. When provided, returns the next set of URLs from where the previous request left off due to response size limit."
  },
  "exclude_urls": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "URL path patterns to exclude using glob syntax. For example: `/careers/**`. Excluded URLs will supersede included URLs."
  },
  "include_urls": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "URL path patterns to include using glob syntax. For example: `/blog/**` to only include blog URLs. Only URLs matching these patterns will be returned."
  },
  "search_query": {
   "type": "string",
   "description": "An optional search query to sort the links by search relevance."
  },
  "include_subdomain": {
   "type": "boolean",
   "description": "Include subdomains of the given URL. `true` by default."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/olostep-website-url-mapper-f9a82414/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)