Sentiment Theme Answers

Get Sentiment Theme Answer

post

Get individual AI answers with sentiment details for a specific theme.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

brand_kit_idintegerRequired

The Brand Kit ID

Body

application/json

brand_kit_idintegerRequired

The Brand Kit ID

sentiment_theme_idintegerRequired

The sentiment theme ID to drill into. Use query_analytics with dimensions=[theme] to discover available theme IDs first.

start_datestringOptional

Start date (YYYY-MM-DD). Default: 30 days ago

end_datestringOptional

End date (YYYY-MM-DD). Defaults to yesterday. Must be before today.

topicsinteger[]Optional

Filter by topic IDs

personasinteger[]Optional

Filter by persona IDs

pageintegerOptional

Page number. Default: 1

per_pageintegerOptional

Results per page (1-50). Default: 10

Responses

200

Successful response

application/json

errorstringOptional

Error message if query failed

400

Bad request - invalid parameters, filters, or sort options

401

Unauthorized - invalid or missing authentication token

404

Not found - resource does not exist

412

Precondition failed - AEO not configured for this brand kit

post/public_api/brand_kits/{brand_kit_id}/sentiment_theme_answers

HTTPcURLJavaScriptPython

POST /public_api/brand_kits/{brand_kit_id}/sentiment_theme_answers HTTP/1.1
Host: api.airops.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "brand_kit_id": 1,
  "sentiment_theme_id": 1,
  "start_date": "text",
  "end_date": "text",
  "providers": [
    "chat_gpt"
  ],
  "countries": [
    "AE"
  ],
  "topics": [
    1
  ],
  "personas": [
    1
  ],
  "page": 1,
  "per_page": 1
}

{
  "answers": [
    {
      "answer_id": 1,
      "query_id": 1,
      "provider": "text",
      "sentiment": "positive",
      "confidence": 1,
      "date": "text",
      "answer_text": "text"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total_count": 1,
    "total_pages": 1
  },
  "error": "text"
}