# SignalHarness Sitemap Extract

> SignalHarness Sitemap Extract is a paid API for AI agents from signalharness.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Parses a sitemap URL or raw sitemap XML and returns a structured list of all URLs, child sitemaps, and metadata found within it.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/sitemap_extract/invoke
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signalharness-sitemap-extract-226fd7be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2NwJ1b3bSaz3fUzn-phSt

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 signalharness-sitemap-extract-226fd7be -d '<json body>'
```

Example prompt: Can you extract all the URLs from the sitemap at https://example.com/sitemap.xml and tell me how many pages there are, including any child sitemaps?

## When to prefer this

Choose this endpoint when you need to programmatically discover all URLs published by a website via its sitemap, either by providing the sitemap URL for live fetching or by passing raw XML for offline parsing. Ideal for SEO audits, content indexing pipelines, site crawl preparation, and detecting malformed sitemap entries. Prefer over generic web scrapers when the site publishes a structured sitemap.xml or sitemap index.

## Known failure modes

- Invalid or non-HTTPS URL provided — rejected by schema pattern validation
- Sitemap URL returns a non-200 HTTP response or is unreachable
- Provided XML exceeds the 65536-character limit
- Malformed XML that cannot be parsed — may return warnings or partial results
- URL not pointing to a valid sitemap format — empty results with warnings

## How this service works

Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.

## Output

Returns a JSON object containing: the sitemap kind (urlset or sitemapindex), a flat list of all discovered URLs, counts of valid URLs, malformed entries, and child sitemaps, a list of any warnings encountered, and references to any child/nested sitemaps found within the document.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "pattern": "^https://",
   "maxLength": 2048,
   "minLength": 9
  },
  "xml": {
   "type": "string",
   "maxLength": 65536,
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "kind": "urlset",
   "urls": [
    {
     "url": "https://example.com/resource",
     "lastmod": "example",
     "priority": "example",
     "alternates": [
      {
       "href": "example00",
       "language": "example"
      }
     ],
     "changefreq": "example"
    }
   ],
   "counts": {
    "urls": 0,
    "malformed": 0,
    "childSitemaps": 0
   },
   "warnings": [
    "Verify the caller-supplied data before relying on this result."
   ],
   "childSitemaps": [
    {
     "url": "https://example.com/resource",
     "lastmod": "example"
    }
   ]
  },
  "status": "succeeded",
  "receipt": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "usage": [],
   "status": "succeeded",
   "network": "eip155:8453",
   "artifacts": [],
   "endedAtMs": 0,
   "latencyMs": 0,
   "paymentId": "example-payment",
   "receiptId": "example-receipt",
   "requestId": "example-request",
   "serviceId": "sitemap_extract",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "10000",
   "resultSha256": "6dd3583feb5ce645bf8e45d6ec2d59ea95858baef0e089fc7b4cf8cd7800f697",
   "serviceVersion": "1.0.0",
   "settlementReference": "0x0000000000000000000000000000000000000000000000000000000000000000"
  },
  "artifacts": [],
  "requestId": "example-request",
  "executionId": "example-execution"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signalharness-sitemap-extract-226fd7be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signalharness.ai](https://www.zero.xyz/host/signalharness.ai/llms.txt)