Add questions to track.

Up to 50 at a time. A question already on the list is not duplicated; it is reopened if it was ignored. Set monitor_in_ai to have it checked in AI answers on the website schedule, within your plan limit. Spends no SoftSolz AI credits.

POSThttps://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.

Body Params

questionsarray of objectsrequired

The questions to add.

Response

Response Body

createdintegerQuestions added.

existingintegerQuestions that were already on the list.

questionsarray of objectsEvery question you sent, as stored.

Request

curl --request POST \
  --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/questions \
  --header 'Authorization: Bearer sk_live_your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "questions": [
    {
      "question": "How long does a boiler service take?",
      "monitor_in_ai": true
    }
  ]
}'

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": {
    "created": 1,
    "existing": 0,
    "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
      }
    ]
  }
}