API playground
Run a live audit against the visible4ai analyse API straight from your browser. See the full reference.
POST
/api/v1/analyseRun a visibility audit on a URLAuthenticated with a Bearer API key. PRO or Business plan required. Rate limit: 100 requests / 15 min, 1000 / 24 h per key.
Authorization
BearerStays in this browser tab and is not saved anywhere. Create or manage keys →
Request body
application/json| Field | Type | Required | Description |
|---|---|---|---|
| url | string | Required | Absolute URL to audit. Must use http or https and resolve to a public host. |
| fresh | boolean | Optional | When true, bypasses the 6-hour domain cache and runs a new analysis, which uses one analysis of your plan. With your analyses used up, you get the cached result if there is one. Default false. |
Example
json
{
"url": "https://example.com",
"fresh": false
}Try it out
Server response
No request sent yet. Fill in the form above and click Execute.
Response fields
200 OKTop-level keys on a successful audit response. Nested objects (visibility, files, eeat, etc.) follow the same shape used by the web UI; drill into the live response above to see them.
| Field | Type | Description |
|---|---|---|
| url | string | Echo of the URL you sent. Useful when an agent sends many requests in parallel. |
| domain | string | Hostname extracted from url, with the www. prefix stripped. The cache is keyed by it. |
| geoScore | number | GEO score, 0–100: readiness from the on-page audit (up to 40) plus visibility from citations (up to 60). |
| scoreSummary | object | Both parts of the GEO score and the numbers behind them: readinessScore from auditScore of auditScoreMax, visibilityScore from citedChecks of checkedChecks. version is 2. Older stored analyses have no version and use the earlier fields, or have no scoreSummary at all. |
| title | string | The page's HTML <title> tag, trimmed. |
| metaDescription | string | The page's <meta name="description"> content, trimmed. |
| summary | string | One-paragraph synthesis of the audit findings, written in plain language. |
| visibility | object | Whether each AI tool cites your domain right now. Booleans keyed by provider: perplexity, openai, gemini, claude. |
| citations | object | Citation snippets returned by each AI tool, keyed by provider. Each entry has the source text and the URL the AI tool linked to. |
| files | object | Each AI file's status (e.g. llmsTxt.present, aiTxt.present). None of them carries points. |
| eeat | object | E-E-A-T signal breakdown: experience, expertise, authoritativeness, trustworthiness. |
| lightAudit | object | Audit summary: bullets, quick wins, crawl status. Its score repeats the final GEO score, not the audit points. |
| recommendations | array | Prioritised quick wins. Each item has title, priority (high / medium / low), and a one-paragraph explanation. |
| _cached | boolean | true if served from the 6-hour domain cache, which uses no analysis of your plan. Send "fresh": true in the request body to bypass it. |
| _cacheExpiresAt | number | Unix milliseconds when the cached entry expires. Only present when _cached is true. |
Responses
| Status | Meaning |
|---|---|
| 200 | Successful audit. JSON payload with geoScore, files, citations, recommendations, _cached, _cacheExpiresAt. |
| 400 | Missing, malformed, or non-public URL in the request body. |
| 401 | Missing, invalid, or revoked API key. |
| 403 | Account does not have a PRO or Business plan. |
| 413 | Request body exceeded the 16 KB limit. |
| 429 | Per-key rate limit hit. Honour the Retry-After header. |
| 502 | Transient crawl or analysis failure. Retry; contact support if it persists. |