GET /sites/sentiment

Returns sentiment analysis for each question across all series.

Request

Endpoint

https://app.knowatoa.com/api/v2/sites/sentiment

Query Parameters

Parameter	Type	Required	Description
site_id	string	Yes	Site prefix ID (e.g., tpc_abc123)
api_key	string	Yes	Your API authentication key
flat	string	No	Set to "true" for flat JSON format
format	string	No	Set to "csv" for CSV export

Response

Nested JSON Format

{
  "site": {
    "id": "tpc_abc123",
    "name": "Example Site",
    "external_id": "example.com"
  },
  "refresh_date": "2025-01-15",
  "series": [
    {
      "id": "ser_xyz789",
      "name": "ChatGPT"
    }
  ],
  "sentiment": [
    {
      "question": "What is example?",
      "series_tracked": 5,
      "mentions": 3,
      "percent_mentioned": 60.0,
      "chat_gpt_sentiment": "Positive",
      "perplexity_sentiment": null
    }
  ]
}

Response Fields

Field	Type	Description
series_tracked	integer	Total number of series tracked
mentions	integer	Number of series mentioning the site
percent_mentioned	float	Percentage of series with mentions
[series]_sentiment	string	Sentiment label or null if not mentioned

Notes

Sentiment values: "Positive", "Negative", "Neutral", "Mixed", or null
Percent calculations rounded to 1 decimal place