SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

How well the site is structured for AI search

A score out of 100 per page, built only from what is on the page: whether it answers directly in the opening sentence, whether subheadings ask real questions, structured data, lists and tables, entity clarity, freshness, a named author, crawlability, scannability and internal links in. This measures readiness, not outcome: nobody can verify whether an AI answer used a page, and this endpoint never claims to.

GEThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/ai-readiness

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

site_idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Query Params

limitinteger

How many weak pages to return, up to 200.

Response

Response Body

summaryobjectAverage across the pages that have been scored.
weakestarray of objectsLowest scoring first, with the component breakdown.
notestringThe honesty note, shown wherever this score appears.

Request

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/ai-readiness \
--header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"summary": {
"average": 68.4,
"scored": 120,
"weak": 22
},
"weakest": [
{
"url": "https://example.com/pricing",
"path": "/pricing",
"page_type": "pricing",
"http_status": 200,
"word_count": 820,
"title": "Pricing",
"meta_description": null,
"h1_count": 1,
"schema_types": [
"Product"
],
"image_count": 12,
"image_missing_alt": 3,
"noindex": false,
"canonical_state": "self",
"depth": 2,
"inbound_internal_links": 14,
"coverage_score": 64.2,
"ai_readiness_score": 71,
"pagerank_rank": 4,
"last_crawled_at": null,
"content_changed_on": "2026-08-14",
"text_truncated": false
}
],
"note": "Measured from the page itself."
}
}