public-api

Get Audit Findings Public

Return the audit issues + flagged pages for a brand's latest (or specified) audit. This is the "what's wrong" surface for an AI-search technical audit, mirroring the data the Optimize page's Findings and Pages tabs render from.

Dismissals are applied: a check the customer marked intentional in Optimize reads as status='ignored' here rather than open, and stays that way across re-scans. Pass issue_status=ignored to list them.

Returns status='no_audit_yet' if the brand has no completed audit yet.

Read-only. Never triggers an audit or any analysis.

get/get-audit-findings

Request

  • Base URL: https://api.trakkr.ai
  • URL: https://api.trakkr.ai/get-audit-findings
  • Auth: HTTP bearer

Query parameters

brand_idstring uuid required

Brand UUID

audit_idstring nullable

Specific audit UUID. Defaults to the latest complete audit for the brand.

severitystring nullable

Comma-separated severities: critical, high, medium, low.

issue_statusstring nullable

Comma-separated issue statuses: open, in_progress, fixed, ignored.

check_namestring nullable

Filter to a single check. Names, aliases and casing are resolved ('schema', 'schema_markup' and 'Schema Markup' all match), and a resolved name is filtered in the database so page counts are complete on large sites. Anything else falls back to a substring scan over a capped page slice, reported as filters_applied.check_filter_mode.

page_urlstring nullable

Filter issues whose affected_urls contain this URL substring.

page_typestring nullable

Filter audit_pages by page_type.

url_patternstring nullable

Filter audit_pages by URL substring.

min_scoreinteger nullable

Min technical_score for pages.

max_scoreinteger nullable

Max technical_score for pages.

issues_limitinteger

Max issues to return.

pages_limitinteger

Max pages to return. 100 covers a whole site on almost every audit; pages_total_matching reports the true total either way.

full_urlsboolean

Return the complete affected_urls list for each issue instead of a sample. Requires check_name so the response stays bounded.

Response

Successful Response

status'ok' | 'no_audit_yet'
issues_countinteger
pages_countinteger
pages_total_matchinginteger nullable
pages_truncatedboolean
filters_appliedobject
notestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.