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.
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/ai-readinessRecent Requests
Kept only in this browserPath Params
site_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Query Params
limitintegerHow 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." }}