How well your website answers the questions people ask.

Coverage weighted by Search Console demand, the average answer score, questions you show up for without a direct answer, pages that could use question or step markup, and how many questions each competitor answers in its headings. Spends no SoftSolz AI credits.

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

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.

Response

Response Body

summaryobjectTotals.

top_unansweredarray of objectsMost searched questions with no answer.

weakest_answersarray of objectsAnswers with the lowest scores.

snippet_candidatesarray of objectsQuestions where you rank 2 to 10 but no page answers in its first sentence.

markuparray of objectsPages that could use question or step markup.

competitor_question_countsarray of objectsQuestions each competitor answers in its headings.

evaluated_atstring | nullWhen answers were last checked.

Request

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

Credentials

Authorization

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": {
      "total": 120,
      "by_coverage": {
        "answered_well": 30,
        "partial": 20,
        "weak": 10,
        "unanswered": 50,
        "not_checked": 10
      },
      "weighted_coverage": 46.5,
      "answer_quality_avg": 58.2,
      "snippet_candidates": 6,
      "markup_fitting": 50,
      "freshness": 70
    },
    "top_unanswered": [
      {
        "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
        "question": "How much does a boiler service cost?",
        "kind": "pricing",
        "intent": "commercial",
        "sources": [
          "search_console"
        ],
        "topic_id": null,
        "topic_label": null,
        "query_id": null,
        "demand": {
          "impressions": 420,
          "clicks": 12,
          "position": 6.3,
          "measured": true,
          "period": "2026-07-01/2026-09-30"
        },
        "best_page_url": "https://example.com/boiler-service",
        "match_basis": "search_console_pair",
        "coverage": "partial",
        "answer_score": 55,
        "checks": [
          {
            "key": "direct_answer",
            "label": "The first sentence answers it directly",
            "passed": false,
            "weight": 25,
            "detail": "The first sentence does not use the key words of the question."
          }
        ],
        "status": "open",
        "ai_monitored": false,
        "ai_priority": 2,
        "ai_models": null,
        "ai_last_checked_at": null,
        "ai_next_check_at": null,
        "ai_latest": null,
        "author_label": null,
        "evaluated_at": null
      }
    ],
    "weakest_answers": [
      {
        "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
        "question": "How much does a boiler service cost?",
        "kind": "pricing",
        "intent": "commercial",
        "sources": [
          "search_console"
        ],
        "topic_id": null,
        "topic_label": null,
        "query_id": null,
        "demand": {
          "impressions": 420,
          "clicks": 12,
          "position": 6.3,
          "measured": true,
          "period": "2026-07-01/2026-09-30"
        },
        "best_page_url": "https://example.com/boiler-service",
        "match_basis": "search_console_pair",
        "coverage": "partial",
        "answer_score": 55,
        "checks": [
          {
            "key": "direct_answer",
            "label": "The first sentence answers it directly",
            "passed": false,
            "weight": 25,
            "detail": "The first sentence does not use the key words of the question."
          }
        ],
        "status": "open",
        "ai_monitored": false,
        "ai_priority": 2,
        "ai_models": null,
        "ai_last_checked_at": null,
        "ai_next_check_at": null,
        "ai_latest": null,
        "author_label": null,
        "evaluated_at": null
      }
    ],
    "snippet_candidates": [
      {
        "question": "how much is a boiler service",
        "position": 4.2,
        "impressions": 300
      }
    ],
    "markup": [
      {
        "page_url": "https://example.com/faq",
        "suggested": "FAQPage"
      }
    ],
    "competitor_question_counts": [
      {
        "name": "rival.com",
        "questions": 14
      }
    ],
    "evaluated_at": null
  }
}