GET /sites/questions

Returns all questions for a site with series mentions, sentiment, and competitor information.

Request

Endpoint

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

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

Example Requests

# Nested JSON (default)
https://app.knowatoa.com/api/v2/sites/questions?site_id=tpc_abc123&api_key=YOUR_API_KEY

# Flat JSON (for BI tools)
https://app.knowatoa.com/api/v2/sites/questions?site_id=tpc_abc123&api_key=YOUR_API_KEY&flat=true

# CSV export
https://app.knowatoa.com/api/v2/sites/questions?site_id=tpc_abc123&api_key=YOUR_API_KEY&format=csv

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"
    }
  ],
  "questions": [
    {
      "question": "What is example?",
      "locale": "EN-US",
      "chat_gpt_mentions": true,
      "chat_gpt_sentiment": "Positive",
      "competitor_mentions": ["Competitor A", "Competitor B"]
    }
  ]
}

Flat JSON Format

[
  {
    "site_id": "tpc_abc123",
    "site_name": "Example Site",
    "external_id": "example.com",
    "refresh_date": "2025-01-15",
    "question": "What is example?",
    "locale": "EN-US",
    "chat_gpt_mentions": true,
    "chat_gpt_sentiment": "Positive",
    "competitor_mentions": "Competitor A, Competitor B"
  }
]

Response Fields (Nested)

Field	Type	Description
site	object	Site information
refresh_date	string	Date of latest refresh (YYYY-MM-DD)
series	array	Available series being tracked
questions	array	Array of question data
questions[].question	string	The question text
questions[].locale	string	Question locale (e.g., "EN-US")
questions[].[series]_mentions	boolean	Whether site mentioned in this series
questions[].[series]_sentiment	string	Sentiment label or null
questions[].competitor_mentions	array	Array of competitor names

Response Fields (Flat)

Field	Type	Description
site_id	string	Site prefix ID
site_name	string	Site display name
external_id	string	Site domain/identifier
refresh_date	string	Date of latest refresh
question	string	The question text
locale	string	Question locale
[series]_mentions	boolean	Whether site mentioned
[series]_sentiment	string	Sentiment label or null
competitor_mentions	string	Comma-separated competitor names

Notes

Series-specific fields are dynamically named (e.g., chat_gpt_mentions, perplexity_mentions)
Sentiment values: "Positive", "Negative", "Neutral", "Mixed", or null
Only includes questions eligible for AI tracking