# toolvend.dev Sitemap Parser

> toolvend.dev Sitemap Parser is a paid API for AI agents from toolvend.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Fetches and parses a sitemap XML or gzip file from a public URL and returns structured JSON, optionally following child sitemaps in a sitemap index.

## Facts

- Endpoint: GET https://toolvend.dev/parse/sitemap
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/toolvend-dev-sitemap-parser-d71f7df4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KDzsaxkpkAgIPK54bEOiZ

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 toolvend-dev-sitemap-parser-d71f7df4
```

Example prompt: Can you fetch the sitemap at https://example.com/sitemap.xml and parse it into JSON — and if it's a sitemap index, follow the first 3 child sitemaps to get the full URL list?

## When to prefer this

Use this endpoint when you need to programmatically extract and parse a website's sitemap into structured JSON for SEO auditing, site crawling, content inventory, or URL discovery. Prefer it over generic HTTP fetchers when you specifically need sitemap XML (including gzipped formats) parsed into clean JSON with optional sitemap-index traversal.

## Known failure modes

- Invalid or inaccessible URL returns an error (private/firewalled URLs not reachable)
- Non-sitemap XML or malformed XML may fail to parse
- Gzip decompression failures for corrupted .xml.gz files
- Sitemap index with follow=N may hit rate limits on child fetches
- Output capped at 500 URLs — large sitemaps are truncated
- follow parameter exceeds maximum of 10

## How this service works

Fetch and parse sitemap XML or gzip into JSON. For an index, follow the first N children with ?follow=N. Caps merged output at 500 URLs.

## Output

A JSON object containing up to 500 parsed sitemap entries, including URLs and any available metadata (lastmod, changefreq, priority). For sitemap indexes with follow>0, child sitemap contents are merged into the response.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Public HTTP(S) sitemap URL, including .xml.gz, or a site origin to try /sitemap.xml"
      },
      "follow": {
       "type": "integer",
       "maximum": 10,
       "minimum": 0,
       "description": "For a sitemap index, fetch and merge the first N children (default 0)"
      }
     }
    }
   },
   "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/toolvend-dev-sitemap-parser-d71f7df4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from toolvend.dev](https://www.zero.xyz/host/toolvend.dev/llms.txt)