apyhub
Back
▣ MODEL KIT · MEDIA KIT

Analyze Webpage Conversion Potential API

What it does

Conversion Score scores a single web page for conversion potential. Send the page URL, and optionally a page type of local_service, ecommerce, saas, or general if you want to override detection.

Use it to evaluate landing pages, service pages, or product pages before a launch, redesign, or A/B test. It fits workflows where you need a quick signal on how well a page is likely to convert without running a full audit manually.

It has one endpoint, Conversion score for one page.

If you're ranking pages across a site, you can call Conversion Score on each URL and compare the results in your own application logic.

The JSON response carries the conversion score, five area scores, the signals found on the page and a prioritized fix list.

GET
Conversion score for one page
https://api.eu.apyhub.com/seoscoreapi/analyze-webpage-conversion

QUICKSTART

GUIDE

Quickstart

Score a page’s conversion performance by passing the page URL as a query parameter.

curl -X GET "https://api.eu.apyhub.com/seoscoreapi/analyze-webpage-conversion?url=https%3A%2F%2Fwww.wikipedia.org" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

A real response to the request above, with every array cut to its first 2 items:

{
  "url": "https://www.wikipedia.org",
  "score": 54.9,
  "grade": "D",
  "page_type": "general",
  "page_type_source": "detected",
  "rendered": false,
  "html_truncated": false,
  "word_count": 1318,
  "categories": {
    "headline": {
      "score": 87.5,
      "weight": 0.222,
      "checks": [
        {
          "name": "h1_present",
          "status": "pass",
          "value": "Wikipedia The Free Encyclopedia",
          "score": 100
        },
        {
          "name": "h1_single",
          "status": "pass",
          "value": 1,
          "score": 100
        }
      ]
    },
    "cta": {
      "score": 84.0,
      "weight": 0.333,
      "checks": [
        {
          "name": "cta_present",
          "status": "pass",
          "value": 5,
          "score": 100
        },
        {
          "name": "cta_near_top",
          "status": "fail",
          "value": {
            "label": "Donate now",
            "position_pct": 52
          },
          "score": 20,
          "recommendation": "Put the main call to action beside or directly under the headline."
        }
      ]
    },
    "trust": {
      "score": 0.0,
      "weight": 0.278,
      "checks": [
        {
          "name": "trust_testimonials",
          "status": "fail",
          "value": null,
          "score": 0
        },
        {
          "name": "trust_ratings",
          "status": "fail",
          "value": null,
          "score": 0
        }
      ]
    },
    "forms": {
      "score": null,
      "weight": 0,
      "checks": [],
      "not_scored": "No form on the page, so form friction doesn't apply. Its weight went to the other areas."
    },
    "objections": {
      "score": 45.0,
      "weight": 0.167,
      "checks": [
        {
          "name": "objection_faq",
          "status": "fail",
          "value": null,
          "score": 0
        },
        {
          "name": "objection_pricing",
          "status": "pass",
          "value": "ikipedia's given you at least $2.75 of knowledge recently. If everyone who found Wikipedia",
          "score": 100
        }
      ]
    }
  },
  "priorities": [
    {
      "severity": "high",
      "category": "cta",
      "issue": "The first call to action appears 52% of the way down the page",
      "fix": "Put the main button or phone link beside or directly under the headline, before any scrolling.",
      "evidence": "First call to action: \"Donate now\"",
      "plain_english": "A visitor has to scroll 52% of the way down before the page asks them to do anything, and many never scroll that far.",
      "who_fixes_it": "developer"
    },
    {
      "severity": "medium",
      "category": "trust",
      "issue": "No testimonials, reviews or ratings found on the page",
      "fix": "Add two or three real customer quotes with names, or your review rating and count, near the call to action.",
      "plain_english": "The page shows no customer reviews or ratings, so a new visitor has only your word that you are good.",
      "who_fixes_it": "marketing"
    }
  ],
  "signals": {
    "h1": "Wikipedia The Free Encyclopedia",
    "cta_count": 5,
    "first_cta": {
      "label": "Donate now",
      "kind": "link",
      "position_pct": 52
    },
    "cta_labels": [
      "Donate now",
      "Download Wikipedia for Android or iOS"
    ],
    "phone_links": 0,
    "trust": {
      "testimonials": null,
      "ratings": null,
      "guarantees": null,
      "contact": null,
      "credentials": null
    },
    "forms": [],
    "embedded_forms": [],
    "objections": {
      "faq": null,
      "pricing": "ikipedia's given you at least $2.75 of knowledge recently. If everyone who found Wikipedia",
      "why_us": null,
      "process": null
    }
  },
  "notes": [
    "\"Near the top\" is measured in source order, not pixels: we read the HTML and do not lay the page out.",
    "This scores what is on the page. It does not measure your actual conversion rate; only your analytics can."
  ],
  "final_url": "https://www.wikipedia.org",
  "response_code": 200
}
TRY ITLIVE · 300 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
The page to score, as a full URL including `https://` (e.g. `https://www.wikipedia.org`).
Page type to score against — `local_service` (a local business), `ecommerce` (a product or shop page), `saas` (a software product) or `general`. Detected from the page when omitted.

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)

AttributeTypeMandatoryDescription
urlStringYesThe page to score (e.g., https://example.com/services)
page_typeStringNolocal_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.

FieldTypeDescription
urlstringThe URL that was checked, as you sent it.
gradestringLetter grade from A+ to F.
notesarray of stringCaveats about how to read the result.
scorenumberScore, 0–100.
signalsobjectWhat the page was found to contain, independent of scoring.
signals.h1stringThe page's H1 text.
signals.formsarray of objectForms found on the page.
signals.trustobjectTrust signals found (each true/false or a count).
signals.trust.testimonialsobjectWhether this trust signal was found on the page.
signals.trust.ratingsobjectWhether this trust signal was found on the page.
signals.trust.guaranteesobjectWhether this trust signal was found on the page.
signals.trust.contactobjectWhether this trust signal was found on the page.
signals.trust.credentialsstring | nullWhether this trust signal was found on the page.
signals.cta_countintegerCalls to action found.
signals.first_ctaobjectThe first call to action on the page.
signals.first_cta.labelstringIts visible text.
signals.first_cta.kindstringWhat kind of element it is — e.g. button, link, form, phone.
signals.first_cta.position_pctintegerHow far down the page it appears, as a percentage of page height.
signals.cta_labelsarray of stringVisible text of each call to action.
signals.objectionsobjectObjection-handling content found (each true/false).
signals.objections.faqobjectWhether the page covers this topic.
signals.objections.pricingstringWhether the page covers this topic.
signals.objections.why_usobjectWhether the page covers this topic.
signals.objections.processobjectWhether the page covers this topic.
signals.phone_linksintegertel: phone links found.
signals.embedded_formsarrayForms embedded from other services (e.g. HubSpot, Typeform).
renderedbooleantrue when the page was rendered in a browser before scoring.
final_urlstringURL after redirects.
page_typestringPage type scored against — local_service, ecommerce, saas or general.
categoriesobjectScore per category; each has its checks.
categories.ctaobjectCalls to action: how many, how clear, how early on the page.
categories.cta.scorenumberCategory score, 0–100.
categories.cta.checksarray of objectIndividual checks behind this category's score.
categories.cta.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
categories.cta.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
categories.cta.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
categories.cta.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
categories.cta.weightnumberShare of the overall score this category carries, 0–1.
categories.formsobjectForm labels and inputs.
categories.forms.scorenumberCategory score, 0–100.
categories.forms.checksarrayIndividual checks behind this category's score.
categories.forms.weightnumberShare of the overall score this category carries, 0–1.
categories.forms.not_scoredstringtrue when the category does not apply to this page and was left out of the score.
categories.trustobjectTrust signals: testimonials, ratings, credentials, guarantees, contact details.
categories.trust.scorenumberCategory score, 0–100.
categories.trust.checksarray of objectIndividual checks behind this category's score.
categories.trust.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
categories.trust.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
categories.trust.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
categories.trust.weightnumberShare of the overall score this category carries, 0–1.
categories.headlineobjectIs there one clear, specific headline with supporting copy.
categories.headline.scorenumberCategory score, 0–100.
categories.headline.checksarray of objectIndividual checks behind this category's score.
categories.headline.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
categories.headline.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
categories.headline.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
categories.headline.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
categories.headline.weightnumberShare of the overall score this category carries, 0–1.
categories.objectionsobjectAnswers to buyer objections: pricing, process, FAQ, why-us.
categories.objections.scorenumberCategory score, 0–100.
categories.objections.checksarray of objectIndividual checks behind this category's score.
categories.objections.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
categories.objections.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
categories.objections.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
categories.objections.weightnumberShare of the overall score this category carries, 0–1.
prioritiesarray of objectFix list, most important first.
priorities[].fixstringThe change to make.
priorities[].issuestringThe problem found, in a short phrase.
priorities[].categorystringCategory the issue belongs to (e.g. meta, technical, performance).
priorities[].severitystringHow much fixing it matters — high, medium or low.
priorities[].who_fixes_itstringWho usually makes the fix — e.g. content (copywriter/editor), developer, marketing.
priorities[].plain_englishstringWhy it matters, in plain language for a non-specialist.
priorities[].evidencestringRequest URLs or script snippets that identified it.
word_countintegerWords of visible text on the page.
response_codeintegerHTTP status the page returned.
html_truncatedbooleantrue if the page was larger than the size limit and only the start was checked.
page_type_sourcestringdetected when the type was inferred from the page; otherwise it reflects the page_type you sent.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.