List the pages affected by site audit issues, filtered by issue type or severity, with the details of each.

GEThttps://api.rankparse.com/v1/site-audit/issuesFreeAPI key

Lists the individual problems a site audit found, one row per page and issue. Use it after Get a site audit tells you which issue types occur: for example, filter by broken_internal_link to get every page that links to a broken URL, with the broken targets.

Rows are ordered errors first, then warnings, then notices, then by issue and URL.

Query parameters

site_idstringrequired

A website id from Websites. A missing, unknown, archived or other workspace's id returns 404 site_audit_site_not_found.

audit_idstring

An audit id. Defaults to the newest audit of the website. An id that is not one of this website's audits returns 404 site_audit_not_found.

issue_idstring

Only this issue type, for example duplicate_title. See the catalog. An unknown id returns 400 site_audit_invalid_request.

severitystring

Only error, warning or notice. Any other value returns 400 site_audit_invalid_request.

limitintegerdefault 100

Rows to return, 1 to 500. Any other value returns 400 site_audit_invalid_request.

offsetintegerdefault 0

Rows to skip, for paging.

Response

site_idstring

The website.

audit_idstring | null

The audit the rows belong to. null when the website has no audit, or is not eligible.

statusstring

The audit's status. Issues are written when the audit completes, so a queued or running audit has none yet.

eligibleboolean

Only present, as false, when the website cannot be audited (with reason). The list is then empty. See Eligibility.

totalinteger

Rows matching the filters, across all pages.

issuesarray

The rows for this page of results.

Show properties

urlstring | null

The page. null for an issue about the whole website (no_sitemap).

issue_idstring

For example http_4xx.

severitystring

error, warning or notice.

titlestring | null

What the issue is, in a short sentence.

detailsobject | null

Facts about this occurrence. The fields depend on the issue and are listed in the catalog. Lists such as linked_from, targets and others hold at most 10 URLs. null when the issue has none.

Behavior and limits

Cost: 0 credits. It reads stored results only.
Paging: use limit and offset and stop when offset + issues.length reaches total.
Permissions: needs the site.read capability.
Rate limit: 60 requests per minute per key. See Rate limiting.

Errors

HTTP	Code	When
400	`site_audit_invalid_request`	`issue_id`, `severity`, `limit` or `offset` is not valid.
401	`invalid_api_key`	Missing, invalid or revoked API key.
403	`capability_missing`	Your workspace role cannot read websites.
404	`site_audit_site_not_found`	`site_id` is missing or not a website in your workspace.
404	`site_audit_not_found`	`audit_id` is not an audit of this website.
429	`rate_limited`	More than 60 requests in a minute.

See Errors for the error body format.

MCP tool: get_site_audit_issues (accepts site_id, audit_id, issue_id, severity, limit and offset).

Get a site audit

Issue counts by type and the change since the last audit.

List audited pages

Every crawled page, with its status and inlinks.

curl "https://api.rankparse.com/v1/site-audit/issues?site_id=site_abc123&issue_id=broken_internal_link&limit=50" \
  -H "X-API-Key: rp_your_key"

Response

{
  "site_id": "site_abc123",
  "audit_id": "aud_Qm3x9bT2kZ7vLw1PdRf8N",
  "status": "completed",
  "total": 6,
  "issues": [
    {
      "url": "https://example.com/blog/seo-checklist",
      "issue_id": "broken_internal_link",
      "severity": "error",
      "title": "Page links to a broken internal URL",
      "details": {
        "count": 2,
        "targets": ["https://example.com/old-pricing", "https://example.com/features/legacy"]
      }
    },
    {
      "url": "https://example.com/old-pricing",
      "issue_id": "http_4xx",
      "severity": "error",
      "title": "Page returns a 4xx error",
      "details": {
        "status": 404,
        "linked_from": ["https://example.com/blog/seo-checklist", "https://example.com/"]
      }
    }
  ]
}

400 site_audit_invalid_request

{
  "error": "Bad Request",
  "code": "site_audit_invalid_request",
  "message": "severity must be error, warning or notice"
}

List audit issues

Query parametersCopy Anchor Link

ResponseCopy Anchor Link

Behavior and limitsCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

Get a site audit

List audited pages

Query parameters

Response

Behavior and limits

Errors

Related