---
title: "Sitemap and orphan-page audit"
method: POST
path: "/site/sitemap-audit"
---

# Sitemap and orphan-page audit

`POST /site/sitemap-audit`

## Request

- Base URL: `https://www.agentseo.dev/api/v1`
- URL: `https://www.agentseo.dev/api/v1/site/sitemap-audit`
- Auth: API key in header `x-api-key`

Audit sitemap coverage, sitemap-only orphan candidates, important URLs, canonical/indexability noise, and internal-link gaps. Costs 2 credits and does not call a paid search API.

## Query parameters

- `sync` boolean

## Headers

- `x-project-id` string
- `x-workflow-id` string

## Request body

- SiteSitemapAuditParams: Provide sitemap_url or sitemap_xml. Optional crawl and internal-link exports improve orphan-page detection.
  - `target` string: Optional target brand, domain, or product.
  - `sitemap_url` string, uri: Sitemap URL to fetch.
  - `sitemap_xml` string: Raw sitemap XML.
  - `max_sitemap_children` integer
  - `important_urls` string[]
  - `crawl_urls` object[]
    - `url` string, uri, required
    - `source` string
    - `title` string
    - `status_code` integer
    - `indexable` boolean
    - `canonical_url` string, uri
    - `inbound_internal_links` integer
    - `clicks` number
    - `impressions` number
  - `internal_links` object[]
    - `source_url` string, uri, required
    - `target_url` string, uri, required
    - `anchor` string

## Response `200`

Completed sitemap audit workflow with findings and agent_workflow

- SiteSitemapAuditResponse
  - `target` string, nullable
  - `sitemap_audit` object
  - `agent_workflow` AgentWorkflow
    - `summary` string
    - `decision` 'ready' | 'act_now' | 'monitor' | 'blocker'
    - `confidence` number
    - `recommended_actions` AgentWorkflowAction[]
      - `priority` 'critical' | 'high' | 'medium' | 'low'
      - `action` string
      - `why` string
    - `evidence` AgentWorkflowEvidence[]
      - `finding` string
      - `detail` string
      - `severity` 'critical' | 'high' | 'medium' | 'low'
    - `limitations` string[]
    - `next_calls` AgentWorkflowNextCall[]
      - `endpoint` string
      - `reason` string
  - `markdown_summary` string

## Other responses

- `202`: Job queued or still processing

---

[API](https://skmtc.dev/agentseo/apis/agentseo-api.md) · [All operations](https://skmtc.dev/agentseo/apis/agentseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentseo/apis/agentseo-api/revisions/53a62da6f92c?raw)