List AI model answers recorded for a website.

Newest first. Filter by question, provider, model, source, competitor, topic, whether your brand was named, and date. The answer text is left out here; read one observation to see it. Every number is an observation of what a named AI model said when asked a question on a date. It is never a ranking inside an AI product, and it does not prove that an AI product used a page. Spends no SoftSolz AI credits.

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

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

question_idstring

Only answers to this question.

providerstring

Only this provider, for example openai.

modelstring

Only this model id.

sourcestring

softsolz_check, external_app or manual.

competitor_idstring

Only answers that named or cited this competitor.

topic_idinteger

Only answers to questions in this topic.

mentionedboolean

true or false for your brand.

fromstring

Earliest date, ISO 8601.

tostring

Latest date, ISO 8601. A plain day is inclusive.

limitinteger

Page size, 1 to 200 (default 50).

offsetinteger

Rows to skip.

Response

Response Body

observationsarray of objectsNewest first.

totalintegerMatching answers in total.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/ai-observations \
  --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": {
    "observations": [
      {
        "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
        "question_id": null,
        "question_text": "Where can I buy sourdough in Leeds?",
        "provider": "openai",
        "model_id": "gpt-4o",
        "mode": "web_search",
        "observed_at": "2026-09-01T09:00:00.000Z",
        "source": "external_app",
        "via": "connected_app",
        "author_label": "Claude",
        "brand_mentioned": true,
        "brand_position": 1,
        "brand_recommended": false,
        "own_cited": true,
        "sentiment": null,
        "confidence": null,
        "mentions": [
          {
            "entity": "own",
            "competitor_id": null,
            "name": "Acme Bakery",
            "position": 1,
            "recommended": true
          }
        ],
        "citations": [
          {
            "url": "https://acmebakery.co.uk/sourdough",
            "domain": "acmebakery.co.uk",
            "title": "Sourdough guide",
            "owner": "own",
            "competitor_id": null,
            "page_url": "https://acmebakery.co.uk/sourdough",
            "position": 1,
            "domain_only": false
          }
        ],
        "credits_used": 0,
        "parse_version": "1"
      }
    ],
    "total": 24
  },
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}