# Doc Tools: Sitemap URL Lister

> Doc Tools: Sitemap URL Lister is a paid API for AI agents from agentpay.agentpay-apis.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Fetches and parses a website's sitemaps (following robots.txt and sitemap indexes) to return a list of all URLs on the site.

## Facts

- Endpoint: GET https://agentpay.agentpay-apis.workers.dev/tools/v1/sitemap?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/doc-tools-sitemap-url-lister-f4685c26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I9IJmQQ_C3n8l1uhkVXPl

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 doc-tools-sitemap-url-lister-f4685c26
```

Example prompt: Can you list all the URLs on example.com by reading its sitemap? Pull up to 500 URLs.

## When to prefer this

Use this endpoint when you need a comprehensive list of all publicly indexed pages on a website, especially when starting a site audit, content analysis, or link-checking workflow. Prefer this over manual crawling when the site has a sitemap, as it respects robots.txt and follows sitemap indexes automatically. It is faster and more structured than scraping page links manually.

## Known failure modes

- Site has no sitemap.xml and robots.txt does not reference one — returns empty list
- Sitemap URL is malformed or unreachable — returns error
- Site blocks crawler with 403/401 — access denied error
- Sitemap is too large or nested too deeply — may return partial results up to limit
- Invalid URL format provided — schema validation error

## How this service works

Doc Tools: List a site's URLs from its sitemaps (follows robots.txt and sitemap indexes).

## Output

Returns a list of URLs discovered from the site's sitemaps, following robots.txt references and sitemap index files. Includes up to the specified limit (default 5000) of individual page URLs found across all sitemaps for the given domain or sitemap URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Site origin or sitemap URL"
      },
      "limit": {
       "type": "string",
       "description": "Max URLs (default 5000)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/doc-tools-sitemap-url-lister-f4685c26/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentpay.agentpay-apis.workers.dev](https://www.zero.xyz/host/agentpay.agentpay-apis.workers.dev/llms.txt)