PageCritic Recheck API
The Recheck API from PageCritic — 1 operation(s) for recheck.
The Recheck API from PageCritic — 1 operation(s) for recheck.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/pagecritic-app:pagecritic-app-recheck-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: PageCritic Recheck API
version: 1.0.0
description: 'Audit public landing pages for conversion problems and check whether AI crawlers can read them. No API key needed for the free result. Limits: 5 audits and 15 readiness checks per hour per client. The full report costs $5 USD one-time per page, unlocked by a human at the report_url. Also available as a remote MCP server (Streamable HTTP) at https://pagecritic.app/mcp.'
contact:
email: hello@pagecritic.app
url: https://pagecritic.app
termsOfService: https://pagecritic.app/terms
servers:
- url: https://pagecritic.app
tags:
- name: Recheck
paths:
/api/v1/recheck:
post:
operationId: recheckLandingPage
summary: Recheck a page after fixes and compare with an earlier full report
description: 'Runs a fresh capture of the page behind a full report bought with the same API key and returns the new result with `comparison` against that baseline. Needs an API key and an idempotency key (Idempotency-Key header or idempotency_key), reused on retries: a retry returns the same run and never charges twice. Without confirm: true it only returns the quote (200, status confirmation_required); nothing runs or is charged. The baseline report''s 3 included re-checks are used first (0 credits), then 1 API credit per run. A failed or blocked capture gives the re-check or credit back. The url and language, if sent, must match the baseline. Another key''s audit answers 404.'
parameters:
- name: Idempotency-Key
in: header
required: false
schema:
type: string
minLength: 8
maxLength: 100
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- baseline_audit_id
properties:
baseline_audit_id:
type: string
pattern: ^[a-f0-9]{24}$
idempotency_key:
type: string
minLength: 8
maxLength: 100
description: Or the Idempotency-Key header (one of the two is required).
confirm:
type: boolean
default: false
url:
type: string
format: uri
language:
type: string
enum:
- en
- pt
- es
wait:
type: boolean
default: true
responses:
'200':
description: 'The recheck result (an Audit with comparison and charge) or, without confirm, {status: confirmation_required, quote}.'
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/Audit'
- type: object
properties:
status:
type: string
enum:
- confirmation_required
quote:
$ref: '#/components/schemas/RecheckQuote'
note:
type: string
'400':
description: Missing idempotency key, or url/language that differ from the baseline.
'401':
description: No or unknown API key.
'402':
description: No included re-checks left and no credits; the body carries the quote.
'404':
description: No audit with that id for this key.
'409':
description: The baseline is not a finished full report, or the idempotency key was used for another request.
'429':
description: Rate limit.
security:
- apiKey: []
tags:
- Recheck
components:
schemas:
RecheckQuote:
type: object
properties:
baseline_audit_id:
type: string
url:
type: string
language:
type: string
funded_by:
type: string
enum:
- included_recheck
- api_credit
credit_cost:
type: integer
included_rechecks_left:
type: integer
credits_left:
type: integer
daily_credits_left:
type: integer
Audit:
type: object
properties:
audit_id:
type: string
status:
type: string
enum:
- done
- running
- error
url:
type: string
report_url:
type: string
description: Human-readable report; the $5 full report is unlocked here
score:
type: integer
minimum: 0
maximum: 100
verdict:
type: string
subscores:
type: object
additionalProperties:
type: integer
launch_ready:
type: object
description: Whether the page clears PageCritic's launch bar (six checks, not a score cut-off) and which checks still block it.
properties:
ready:
type: boolean
blockers:
type: array
items:
type: object
properties:
id:
type: string
name:
type: string
bar:
type: string
format: uri
top_issues:
type: array
items:
$ref: '#/components/schemas/Issue'
what_works:
type: array
items:
type: string
ai_readiness:
type:
- object
- 'null'
ai_summary:
type:
- string
- 'null'
benchmark:
type:
- object
- 'null'
description: 'Where the page stands among the well-known homepages PageCritic has ranked (n, as_of, ranking_url). score: {value, higher_than_pct (rounded to 5), median, band}. band is top quarter, above the median, about the median (within 4 points; runs vary by about 4), below the median or bottom quarter. With full_report unlocked it adds the same for each of the 7 subscores.'
score_history:
type:
- array
- 'null'
description: 'When this audit is the third or later run of "audit again" on the same page (same host and path): every run oldest first, at most 12, each {id, score, subscores, created}. Null otherwise. Runs of an unchanged page vary by about 4 points.'
items:
type: object
fix_prompt:
type: string
description: Markdown repair tasks generated from fix_tasks, with per-check evidence, completion conditions and a publish-then-human-recheck step. Keep the design and verify real facts. Free agent results include the top 3 issues; unlocked results include every issue plus rewrite options and reference material. A cached result or a higher total score does not prove a task is complete.
full_report:
type: object
properties:
unlocked:
type: boolean
locked_issues:
type: integer
price_usd:
type: number
example: 19
error:
type: string
language:
type: string
enum:
- en
- pt
- es
description: Language the report is written in
fix_tasks:
type: object
description: Versioned repair plan shared with fix_prompt. Scope top_issues for free agents, full for unlocked results. Unknown evidence, locations and point totals remain null or explicitly unknown. Element IDs are capture references, never DOM selectors. Completion conditions use the existing rubric, not a promise of revenue or deterministic judged results. The free web teaser excludes this field.
properties:
version:
type: integer
const: 1
scope:
type: string
enum:
- top_issues
- full
language:
type: string
constraints:
type: object
verification:
type: object
description: Supported human live-recheck link after publishing. Existing payment and included-recheck rules apply; no automatic deployment or fresh agent operation is implied.
tasks:
type: array
items:
type: object
required:
- id
- check_ids
- checks
- locations
- proposed_edit
- estimated_effort
- needs
properties:
id:
type: string
check_ids:
type: array
items:
type: string
checks:
type: array
items:
type: object
locations:
type: array
items:
type: object
proposed_edit:
type: string
edits:
type: array
items:
type: string
description: Source suggestions; overlapping suggestions are alternatives within the single proposed edit.
points_available:
type:
- integer
- 'null'
estimated_effort:
type: string
needs:
type: array
items:
type: string
execution:
type: string
captured_at:
type: string
format: date-time
nullable: true
description: When the page was last captured for this result (latest of desktop/mobile).
freshness:
type: object
description: 'Whether this call ran the audit. served: fresh (this call started it), reused_known_site or reused_recent_agent_audit (no-credit cost controls), idempotent_replay (same idempotency key), stored (read by id). Reading never charges.'
properties:
served:
type: string
enum:
- fresh
- reused_known_site
- reused_recent_agent_audit
- idempotent_replay
- stored
cached:
type: boolean
audit_created:
type: string
format: date-time
age_seconds:
type: integer
nullable: true
comparison:
type: object
description: 'Only on a full recheck (POST /api/v1/recheck, or an included re-check of a full report): each check compared with baseline_audit_id. status comparable or incomparable (with reason); check states cleared, improved_still_failing, unchanged, regressed, newly_failing, unable_to_verify.'
properties:
status:
type: string
enum:
- comparable
- incomparable
reason:
type: string
baseline_audit_id:
type: string
counts:
type: object
additionalProperties:
type: integer
checks:
type: array
items:
type: object
properties:
id:
type: string
name:
type: string
state:
type: string
enum:
- cleared
- improved_still_failing
- unchanged
- regressed
- newly_failing
- unable_to_verify
reason:
type: string
before:
type: object
after:
type: object
charge:
type: object
description: 'Only on POST /api/v1/recheck: what this run used.'
properties:
funded_by:
type: string
enum:
- included_recheck
- api_credit
credit_cost:
type: integer
Issue:
type: object
properties:
title:
type: string
impact:
type: string
fix:
type: string
securitySchemes:
apiKey:
type: http
scheme: bearer
description: Optional. Free from POST /api/v1/keys. With credits, audits return the full report.