inspector

Run site inspections

Inspect one page of one of your organization's own websites, or of a competitor site its business profiles name, live and read-only: what it runs on (commerce platform, CMS, theme, front-end framework, site search, storefront apps, payments, edge), each with the exact evidence it rests on, its readable text, and the surfaces you name (robots, llms, markup, forms, negotiation). Answers outside_site for any other host and blocked_by_challenge when the site served a bot challenge, which says nothing about the page. Starts no scan, publishes no score and stores nothing; each answer is dated to its own read. rendered is not available here (a render needs a run that records the browser's use), so it comes back as a limit.

get/api/v1/inspector/site-inspections/run

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/inspector/site-inspections/run
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Query parameters

urlstring uri required

An absolute http(s) URL on one of the organization's websites: the page whose behaviour the question is about (a product page, a search URL such as /search?q=odor, or the home page).

surfacesstring[]

What to read besides the page and what it runs on: robots (/robots.txt), llms (/llms.txt), markup (title, meta robots, canonical, alternate links, structured data types), forms (form actions and fields, such as site search), negotiation (whether the page answers Accept: text/markdown), rendered (the page's text after a browser runs it). Use [] for the page and its platform alone.

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success.

Changes

No recorded changes to this operation across all 1 revision of this API.