About this endpoint
What it does
Scores how well a page asks for the next step: headline, calls to action, trust signals, forms and objection handling. The page type (local service, ecommerce, SaaS or general) is detected or passed in, and changes what is expected.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| url | String | Yes | The page to score (e.g., https://example.com/services) |
| page_type | String | No | local_service, ecommerce, saas or general. Detected from the page when omitted. |
Response
A JSON object; nested fields are written parent.child, and [] marks an array of objects.
| Field | Type | Description |
|---|---|---|
url | string | The URL that was checked, as you sent it. |
grade | string | Letter grade from A+ to F. |
notes | array of string | Caveats about how to read the result. |
score | number | Score, 0–100. |
signals | object | What the page was found to contain, independent of scoring. |
signals.h1 | string | The page's H1 text. |
signals.forms | array of object | Forms found on the page. |
signals.trust | object | Trust signals found (each true/false or a count). |
signals.trust.testimonials | object | Whether this trust signal was found on the page. |
signals.trust.ratings | object | Whether this trust signal was found on the page. |
signals.trust.guarantees | object | Whether this trust signal was found on the page. |
signals.trust.contact | object | Whether this trust signal was found on the page. |
signals.trust.credentials | string | null | Whether this trust signal was found on the page. |
signals.cta_count | integer | Calls to action found. |
signals.first_cta | object | The first call to action on the page. |
signals.first_cta.label | string | Its visible text. |
signals.first_cta.kind | string | What kind of element it is — e.g. button, link, form, phone. |
signals.first_cta.position_pct | integer | How far down the page it appears, as a percentage of page height. |
signals.cta_labels | array of string | Visible text of each call to action. |
signals.objections | object | Objection-handling content found (each true/false). |
signals.objections.faq | object | Whether the page covers this topic. |
signals.objections.pricing | string | Whether the page covers this topic. |
signals.objections.why_us | object | Whether the page covers this topic. |
signals.objections.process | object | Whether the page covers this topic. |
signals.phone_links | integer | tel: phone links found. |
signals.embedded_forms | array | Forms embedded from other services (e.g. HubSpot, Typeform). |
rendered | boolean | true when the page was rendered in a browser before scoring. |
final_url | string | URL after redirects. |
page_type | string | Page type scored against — local_service, ecommerce, saas or general. |
categories | object | Score per category; each has its checks. |
categories.cta | object | Calls to action: how many, how clear, how early on the page. |
categories.cta.score | number | Category score, 0–100. |
categories.cta.checks | array of object | Individual checks behind this category's score. |
categories.cta.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
categories.cta.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
categories.cta.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
categories.cta.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
categories.cta.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
categories.cta.weight | number | Share of the overall score this category carries, 0–1. |
categories.forms | object | Form labels and inputs. |
categories.forms.score | number | Category score, 0–100. |
categories.forms.checks | array | Individual checks behind this category's score. |
categories.forms.weight | number | Share of the overall score this category carries, 0–1. |
categories.forms.not_scored | string | true when the category does not apply to this page and was left out of the score. |
categories.trust | object | Trust signals: testimonials, ratings, credentials, guarantees, contact details. |
categories.trust.score | number | Category score, 0–100. |
categories.trust.checks | array of object | Individual checks behind this category's score. |
categories.trust.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
categories.trust.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
categories.trust.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
categories.trust.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
categories.trust.weight | number | Share of the overall score this category carries, 0–1. |
categories.headline | object | Is there one clear, specific headline with supporting copy. |
categories.headline.score | number | Category score, 0–100. |
categories.headline.checks | array of object | Individual checks behind this category's score. |
categories.headline.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
categories.headline.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
categories.headline.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
categories.headline.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
categories.headline.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
categories.headline.weight | number | Share of the overall score this category carries, 0–1. |
categories.objections | object | Answers to buyer objections: pricing, process, FAQ, why-us. |
categories.objections.score | number | Category score, 0–100. |
categories.objections.checks | array of object | Individual checks behind this category's score. |
categories.objections.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
categories.objections.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
categories.objections.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
categories.objections.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
categories.objections.weight | number | Share of the overall score this category carries, 0–1. |
priorities | array of object | Fix list, most important first. |
priorities[].fix | string | The change to make. |
priorities[].issue | string | The problem found, in a short phrase. |
priorities[].category | string | Category the issue belongs to (e.g. meta, technical, performance). |
priorities[].severity | string | How much fixing it matters — high, medium or low. |
priorities[].who_fixes_it | string | Who usually makes the fix — e.g. content (copywriter/editor), developer, marketing. |
priorities[].plain_english | string | Why it matters, in plain language for a non-specialist. |
priorities[].evidence | string | Request URLs or script snippets that identified it. |
word_count | integer | Words of visible text on the page. |
response_code | integer | HTTP status the page returned. |
html_truncated | boolean | true if the page was larger than the size limit and only the start was checked. |
page_type_source | string | detected when the type was inferred from the page; otherwise it reflects the page_type you sent. |