List the questions people ask and how well you answer them.

Questions found in Search Console, in your own headings and markup and on competitor pages, plus any you add. Open questions only unless you pass status=ignored. Monitored and badly answered questions come first. Spends no SoftSolz AI credits.

GEThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/questions

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

coveragestring

One of answered_well, partial, weak, unanswered, not_checked.

kindstring

One of definition, how_to, comparison, pricing, troubleshooting, local, product, service, other.

sourcestring

One of search_console, page_heading, faq_markup, competitor, user, ai_suggestion, api.

monitoredboolean

true for questions checked in AI answers.

statusstring

open (default) or ignored.

qstring

Text the question must contain.

limitinteger

Page size, 1 to 200 (default 50).

offsetinteger

Rows to skip.

Response

Response Body

questionsarray of objectsOne page of questions.

countsobjectCounts over every open question on the website.

capsobjectHow many questions can be checked in AI answers. A null limit means no limit.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/questions \
  --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": {
    "questions": [
      {
        "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
      }
    ],
    "counts": {
      "total": 120,
      "monitored": 8,
      "ignored": 4,
      "by_coverage": {
        "answered_well": 30,
        "partial": 20,
        "weak": 10,
        "unanswered": 50,
        "not_checked": 10
      },
      "by_kind": {
        "how_to": 40,
        "pricing": 12
      }
    },
    "caps": {
      "monitored_used": 8,
      "monitored_limit": 25
    }
  },
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}