What to write next, and why
Topics with real search demand that the site does not cover, or covers only partly. coverage_score is measured by checking whether the words of each search actually appear in the page title, headings and text; it is a floor, not a ceiling, when coverage_partial is true. Read this, pick a topic_id, then POST /sites/{site_id}/briefs to plan the page. Spends no SoftSolz AI credits.
GET
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/content-gapsRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
site_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Query Params
limitintegerHow many topics, up to 200.
Response
Response Body
revisioninteger | nullWhich build of the topic map this used.period_startstring | nullThe month measured.thresholdsobjectThe coverage thresholds applied.gapsarray of objectsBiggest demand first.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/content-gaps \ --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": { "revision": 3, "period_start": "2026-08-01", "thresholds": { "covered_at": 40, "well_covered_at": 75 }, "gaps": [ { "topic_id": 41, "topic": "payroll software pricing", "slug": "payroll-software-pricing", "intent": "transactional", "kind": "create_page", "impressions": 5400, "clicks": 12, "position": 18.4, "opportunity_clicks": 42.5, "query_count": 23, "coverage_score": 31.5, "measurable": true, "coverage_partial": false, "existing_page": { "page_id": 1335, "url": "https://example.com/pricing", "path": "/pricing" }, "missing_queries": [ { "query_text": "payroll software cost uk", "impressions": 320 } ], "questions": [ "how much is payroll software" ], "url_suggestion": "/payroll-software-pricing", "search_intel": { "geo": { "monitored_questions": 3, "own_mention_rate": 0.25, "competitor_mentions": 7 }, "aeo": { "questions": 9, "unanswered": 4 } } } ] }, "meta": { "limit": 50, "offset": 0, "total": 1, "has_more": false }}