Assessments

Assess a website

Checks a website in one call and scores SEO readiness, AEO readiness and AI access from 0 to 100, with the PageSpeed Insights bands: 90 to 100 good, 50 to 89 needs work, 0 to 49 poor. It runs the selected check groups on the URL and up to two more pages on the same site, and combines their fixes into one list ordered by priority. Each assessment is compared with the previous one of the same URL. progress.percentFixed is the share of the earlier issues that are now fixed, next to counts of fixed, still present and new issues. The default checks cost 67 credits for one page and 47 for each extra page. Each check is charged on its own and refunded if it fails. One call runs checks for 40 seconds, or as long as its slowest selected check: about two minutes for performance and three and a half for AI brand descriptions. Allow a client timeout of four minutes. When status is in_progress, continue with the same id to run the rest.

post/assessments

Request

  • Base URL: https://seogeoaeo.ai/api/v1
  • URL: https://seogeoaeo.ai/api/v1/assessments
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Reuse on retries so the same run is returned instead of charged again. A key only matches a run of the same tool and input, and only while that run is among the workspace's latest 1,000.

Alternative to the idempotencyKey body field.

Request body

compareTostring

Compare with this assessment instead of the previous one of the same URL.

idempotencyKeystring

Reuse on retries so the same run is returned instead of charged again. A key only matches a run of the same tool and input, and only while that run is among the workspace's latest 1,000.

maxCreditsinteger

Refuse the run with max_credits_exceeded if it costs more than this.

Response

The assessment after this call.

Changes

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