PageAudit Shared API
The Shared API from PageAudit — 1 operation(s) for shared.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/pageaudit-shared-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: PageAudit Shared API
version: f5ac3ca0
description: 'Technical SEO auditor that ships the fix. Main client: AI agents. Browsable index at GET /api/.'
servers:
- url: https://pageaudit.online
tags:
- name: Shared
paths:
/api/shared/{slug}:
get:
operationId: get_api_shared_by_slug
summary: Shared report as JSON, without credentials — the machine twin of `/r/:slug`
description: 'Returns: { audit_id, url, score, summary{finalUrl,status,contentType,title,metaDescription,canonical,robots,viewport,charset,lang,favicon,faviconSource,h1s,openGraph,twitter,jsonLdCount,jsonLdBlocks,jsonLdDropped,jsonLdTypes,images,links,words,hreflang,legacy,redirects,robotsTxt,sitemap}, counts{errors,warnings,info}, issues[{severity,code,message}], fixes[{code,severity,classe,alvo,snippet,arquivo,fonte,nota}], jsonLd, headers, truncated, share_slug, created_at }'
security: []
parameters:
- name: slug
in: path
required: true
schema:
type: string
responses:
'200':
description: '{ audit_id, url, score, summary{finalUrl,status,contentType,title,metaDescription,canonical,robots,viewport,charset,lang,favicon,faviconSource,h1s,openGraph,twitter,jsonLdCount,jsonLdBlocks,jsonLdDropped,jsonLdTypes,images,links,words,hreflang,legacy,redirects,robotsTxt,sitemap}, counts{errors,warnings,info}, issues[{severity,code,message}], fixes[{code,severity,classe,alvo,snippet,arquivo,fonte,nota}], jsonLd, headers, truncated, share_slug, created_at }'
content:
application/json:
schema:
$ref: '#/components/schemas/AuditGravado'
'404':
description: Unknown slug, or share revoked.
tags:
- Shared
components:
schemas:
Achado:
type: object
properties:
severity:
type: string
description: Severity of the finding.
code:
type: string
description: Stable check code, e.g. `title_missing`. It is what you filter by.
message:
type: string
description: The finding in one sentence, ready to show a person.
required:
- severity
- code
- message
description: A problem (or a pass) found on the page.
ResumoPagina:
type: object
properties:
finalUrl:
type: string
description: URL after following every redirect.
status:
type: integer
description: Final HTTP status of the target.
contentType:
type: string
description: Content-Type of the final response.
nullable: true
title:
type: string
description: Content of `<title>`.
nullable: true
metaDescription:
type: string
description: Content of `<meta name=description>`.
nullable: true
canonical:
type: string
description: Canonical URL declared by the page.
nullable: true
robots:
type: string
description: Content of `<meta name=robots>`.
nullable: true
viewport:
type: string
description: Content of `<meta name=viewport>`.
nullable: true
charset:
type: string
description: Declared encoding.
nullable: true
lang:
type: string
description: Language declared in `<html lang>`.
nullable: true
favicon:
type: string
description: URL of the favicon found.
nullable: true
faviconSource:
type: string
description: 'How the favicon was found: declared or by the default path.'
nullable: true
h1s:
type: array
items:
type: string
description: Every `<h1>` on the page, in order.
openGraph:
type: object
description: The `og:*` tags found, key by key.
twitter:
type: object
description: The `twitter:*` tags found.
jsonLdCount:
type: integer
description: How many JSON-LD nodes the page had.
jsonLdBlocks:
type: integer
description: How many `<script type=application/ld+json>` blocks existed.
jsonLdDropped:
type: boolean
description: '`true` when nodes were dropped for passing the cap.'
jsonLdTypes:
type: array
items:
type: string
description: The `@type`s found, e.g. `Organization`, `WebSite`.
images:
type: object
description: Image count and how many have no `alt`.
links:
type: object
description: Count of internal, external and text-less links.
words:
type: integer
description: Words in the visible content.
hreflang:
type: array
items:
type: object
description: The declared language alternates.
legacy:
type: object
description: Old markup still present (e.g. `<font>`, layout tables).
redirects:
type: array
items:
type: object
description: The redirect chain followed to the final URL.
robotsTxt:
type: object
description: What the origin's `robots.txt` says about this URL.
sitemap:
type: object
description: Whether the URL appears in the sitemap the origin declares.
required:
- finalUrl
- status
- contentType
- title
- metaDescription
- canonical
- robots
- viewport
- charset
- lang
- favicon
- faviconSource
- h1s
- openGraph
- twitter
- jsonLdCount
- jsonLdBlocks
- jsonLdDropped
- jsonLdTypes
- images
- links
- words
- hreflang
- legacy
- redirects
- robotsTxt
- sitemap
description: Everything the page declares about itself. It is the most consulted object of the API.
AuditGravado:
type: object
properties:
audit_id:
type: string
description: ID of the audit.
url:
type: string
description: Final audited URL, after following the redirects.
score:
type: integer
description: Score from 0 to 100.
summary:
allOf:
- $ref: '#/components/schemas/ResumoPagina'
description: What the page declared at the time of the run.
nullable: true
counts:
allOf:
- $ref: '#/components/schemas/ContagemAchados'
description: How many findings of each severity.
issues:
type: array
items:
$ref: '#/components/schemas/Achado'
description: Everything found in that run.
fixes:
type: array
items:
$ref: '#/components/schemas/Correcao'
description: The ready fix of each finding; an audit stored before this existed gets the computation on read.
jsonLd:
type: array
items:
type: object
description: The raw JSON-LD blocks stored.
headers:
type: object
description: Headers of the target's response, as they were in the run.
truncated:
type: array
items:
type: string
description: What was cut by size when storing.
share_slug:
type: string
description: Public slug, if this audit was shared.
nullable: true
created_at:
type: string
description: When the run happened (UTC).
required:
- audit_id
- url
- score
- summary
- counts
- issues
- fixes
- jsonLd
- headers
- truncated
- share_slug
- created_at
description: The same report re-read from the database. It has no `quota` and no `_links` (it is a read, not a run) and gains the date and the share slug.
Correcao:
type: object
properties:
code:
type: string
description: The same `code` as the finding (`Achado.code`).
severity:
type: string
description: Severity of the source finding.
classe:
type: string
description: '`deterministico` comes whole from the page; `molde` has a `{{…}}` placeholder; `sem_patch` is an instruction.'
alvo:
type: string
description: 'Where to apply: `head`, `corpo`, `img`, `arquivo` or `pagina` (instruction).'
snippet:
type: string
description: The ready tag (or with a placeholder). `null` for files and for `sem_patch`.
nullable: true
arquivo:
type: object
description: '`path` and `conteudo` when the fix is a file at the host root.'
nullable: true
fonte:
type: string
description: Where the value came from, or what the page already had (for the template or to check the cut).
nullable: true
nota:
type: string
description: How to apply, or what to decide.
nullable: true
required:
- code
- severity
- classe
- alvo
- snippet
- arquivo
- fonte
- nota
description: The ready fix of one finding. `classe` says whether it is to paste, to fill in or to decide.
ContagemAchados:
type: object
properties:
errors:
type: integer
description: Serious findings.
warnings:
type: integer
description: Findings that deserve attention.
info:
type: integer
description: Observations without severity.
required:
- errors
- warnings
- info
description: How many findings of each severity — the summary that fits in a badge.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Guest token (`POST /api/guest`) in `X-Guest-Token: pa_…`, `Authorization: Bearer pa_…` or `?guest_token=pa_…`. A user session (`sess_…`) also works and takes precedence.'