PageCritic Recheck API

The Recheck API from PageCritic — 1 operation(s) for recheck.

GitHub OpenAPI

Operations 1

POST /api/v1/recheck Recheck a page after fixes and compare with an earlier full report #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/pagecritic-app:pagecritic-app-recheck-api"
All apis
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.

Get an API 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 Specification

pagecritic-app-recheck-api-openapi.yml Raw ↑
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.