Skip to main content
POST
Run Free Audit

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The one free-audit entry point — authenticated only.

The anonymous twin (AnonFreeAuditRequest) was removed on 2026-09-08; the two optional inputs only it used to accept live here now.

url
string
required

Business website required for every audit, including single-platform Social Media audits. Supply social profile URLs in social_links.

Required string length: 5 - 500
audit_type
string
required
market
BrandMarketSelection · object | null
request_id
string<uuid> | null

Caller-defined replay key. Reuse the same ID to retry the same operation; omit it to intentionally start a new operation.

legacy_session_token
string | null
Required string length: 8 - 64
platform
string | null

Optional Social Media audit platform filter. The url field remains the business website; it is never a social profile URL.

Response

Successful Response

id
string<uuid>
required
brand_id
string<uuid>
required
audit_type
string
required
status
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
active_brand_id
string<uuid> | null
source_brand_id
string<uuid> | null
read_only_history
boolean
default:false
platform
string | null
overall_score
number | null
summary
string | null
results
Results · object
recommendations
any[]
output_files
any[]
cost_usd
number
default:0
error_message
string | null
started_at
string<date-time> | null
completed_at
string<date-time> | null