# x402serps Website URL Mapper

> x402serps Website URL Mapper is a paid API for AI agents from x402serps.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-16).

Crawls a website domain and returns up to 1000 discovered URLs by parsing robots.txt, sitemaps, and on-page links

## Facts

- Endpoint: POST https://x402serps.com/api/v1/map?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402serps-website-url-mapper-2aebf721
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5VEbCPfEwalcUb5CSFCct

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

Example prompt: Map all the pages you can find on shopify.com — discover up to 500 URLs using their sitemaps and on-page links, and only return ones that contain '/blog' in the URL.

## When to prefer this

Use this endpoint when you need to enumerate or inventory the pages of a website — especially for SEO audits, content discovery, site migration planning, or building a URL corpus for further processing. It is ideal when you need a broad, flat list of URLs from robots.txt, sitemaps, and crawled links in a single paid call, rather than recursively scraping each page yourself.

## Known failure modes

- Invalid or unreachable URL returns an error
- Domains with no sitemap or robots.txt may return fewer URLs than expected
- Limit outside 1-1000 range may be rejected or clamped
- Private or authentication-gated pages will not be discovered
- Heavily JavaScript-rendered sites may yield fewer links

## How this service works

map a website — discover up to 1000 URLs on a domain from robots.txt sitemaps and on-page links (flat price)

## Output

A JSON object containing the original URL queried, an array of discovered URLs found on the domain (up to the specified limit), a count of URLs returned, and a source field indicating where URLs were found (robots.txt, sitemaps, on-page links).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Site URL or domain"
  },
  "limit": {
   "type": "number",
   "description": "Max URLs 1-1000, default 200"
  },
  "search": {
   "type": "string",
   "description": "Only return URLs containing this substring"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://x402.org",
  "urls": [
   "https://www.x402.org/",
   "https://www.x402.org/ecosystem"
  ],
  "count": 42
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402serps-website-url-mapper-2aebf721/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402serps.com](https://www.zero.xyz/host/x402serps.com/llms.txt)
