LLllmpulse
GEO Audits

Run a GEO audit now

Changed on

Starts a run and returns it with status queued; poll GET /geo_audits/{geo_audit_id}/runs/{sequence} until status is completed, failed or unreachable. Limited to 6 manual runs per audit per rolling hour and 200 per account per day (ERR_LIMIT_REACHED); scheduled runs do not count. Requires a read_write scope API key.

post/geo_audits/{geo_audit_id}/runs

Request

  • Base URL
    https://api.llmpulse.ai/api/v1
  • URL
    https://api.llmpulse.ai/api/v1/geo_audits/{geo_audit_id}/runs
  • Auth
    API key in header Authorization

Path parameters

geo_audit_idstring required

Audit id

Query parameters

project_idinteger required

Project ID

Response

The new run

sequenceinteger

Run number within the audit, starting at 1

status'queued' | 'running' | 'completed' | 'failed' | 'unreachable'
trigger'scheduled' | 'manual' | 'api' | 'mcp' | 'legacy_import'
scorenumber nullable
gradestring nullable
score_deltanumber nullable

Score change against the previous completed run

comparable_to_previousboolean

False when the checks or the audit settings changed since the previous run, so a diff may reflect that change

new_issuesinteger
fixed_issuesinteger
regressed_issuesinteger
errorstring nullable
engine_versionstring nullable
created_atstring date-time
finished_atstring date-time nullable
app_urlstring
project_idinteger
request_idstring

Changes