Record what an AI model answered when you asked it a question.

Ask the question in your own AI product, then send what the model said: the question, provider, model, date, the answer text and the sources it listed. SoftSolz reads the answer for your brand and your tracked competitors itself and classifies each source; brands you supply are stored too and labelled with your app. Up to 50 per call and 500 per website a day. Sending the same answer twice is counted as a duplicate, not stored twice. Cited addresses are never fetched. Spends no SoftSolz AI credits.

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

Body Params

observationsarray of objectsrequired

Up to 50 answers.

Response

Response Body

createdintegerAnswers stored.

duplicatesintegerAnswers already stored before.

observationsarray of objectsThe stored answers.

Request

curl --request POST \
  --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/ai-observations \
  --header 'Authorization: Bearer sk_live_your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "observations": [
    {
      "question": "Where can I buy sourdough in Leeds?",
      "provider": "anthropic",
      "model_id": "claude-sonnet-4-5",
      "observed_at": "2026-10-08T09:00:00.000Z",
      "answer_excerpt": "Acme Bakery in Leeds is a good choice for sourdough.",
      "citations": [
        {
          "url": "https://acmebakery.co.uk/sourdough",
          "title": "Sourdough"
        }
      ]
    }
  ]
}'

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 · 201

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