PageCritic Audit API

The Audit API from PageCritic — 2 operation(s) for audit.

GitHub OpenAPI

Operations 2

POST /api/v1/audit Audit a landing page (free result) #
GET /api/v1/audit/{id} Get an audit result by id #

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-audit-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-audit-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: PageCritic Audit 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: Audit
paths:
  /api/v1/audit:
    post:
      operationId: auditLandingPage
      summary: Audit a landing page (free result)
      description: Loads the page in a real browser (desktop and mobile) and returns a conversion score 0-100, 7 sub-scores, the top 3 issues with fixes, what works and an AI-readiness score. Waits up to 85 seconds; if status is "running", poll GET /api/v1/audit/{id}. Free. The full report is $5 at report_url. With an API key that has credits, one credit is spent and full_report holds the whole report (10 full reports cost $29 via POST /api/v1/credits). Without usable credits, results for the same URL and language are normally reused for 24 hours; selected well-known sites can reuse reports for up to 7 days. A paid-credit audit runs fresh within the daily spend cap, except an idempotent REST retry returns its original audit without another charge. The free web report shows issue titles and a prompt preview; this free agent result includes the top-3 fixes and prompt. The 3 rechecks included with a web unlock are not API credits.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - url
              properties:
                url:
                  type: string
                  format: uri
                  example: https://example.com
                lang:
                  type: string
                  enum:
                  - en
                  - pt
                  - es
                  default: en
                  description: 'Report language: en (English), pt (Brazilian Portuguese) or es (Latin American Spanish). Headline and CTA rewrites stay in the page''s language. Prices stay in USD.'
                wait:
                  type: boolean
                  default: true
                  description: false returns at once with status running
      responses:
        '200':
          description: Audit result (done, running or error)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Audit'
        '400':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - apiKey: []
      parameters:
      - name: Idempotency-Key
        in: header
        required: false
        schema:
          type: string
          maxLength: 100
        description: Retries with the same key return the same audit without spending another credit.
      tags:
      - Audit
  /api/v1/audit/{id}:
    get:
      operationId: getAudit
      summary: Get an audit result by id
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[a-f0-9]{24}$
      responses:
        '200':
          description: Audit result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Audit'
        '404':
          $ref: '#/components/responses/Error'
      tags:
      - Audit
components:
  schemas:
    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
  responses:
    Error:
      description: Error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Optional. Free from POST /api/v1/keys. With credits, audits return the full report.