Read one AI model answer, with its text.

answer_excerpt is plain text, up to 12,000 characters, kept for 180 days. evidence holds how the answer was read and anything the sending app attached. 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/{observation_id}

Recent Requests

Kept only in this browser

TimeStatusTook

Send a request with Try it to see it here.

Path Params

site_idstringrequired

observation_idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Response

Response Body

observationobjectOne AI model answer with its text.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/ai-observations/{observation_id} \
  --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": {
    "observation": {
      "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",
      "answer_excerpt": "Acme Bakery in Leeds is a good choice.",
      "evidence": {
        "detection": "softsolz"
      }
    }
  }
}