GET /account/questions

Returns all questions across all sites in your account with mentions and sentiment data.

Request

Endpoint

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

Query Parameters

Parameter Type Required Description
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
https://app.knowatoa.com/api/v2/account/questions?api_key=YOUR_API_KEY

# Flat JSON
https://app.knowatoa.com/api/v2/account/questions?api_key=YOUR_API_KEY&flat=true

# CSV
https://app.knowatoa.com/api/v2/account/questions?api_key=YOUR_API_KEY&format=csv

Response

Nested JSON Format

{
  "account": {
    "id": "acc_xyz123",
    "name": "Example Account"
  },
  "topics": [
    {
      "site_id": "tpc_abc123",
      "site_name": "Site 1",
      "questions": [
        {
          "site_id": "tpc_abc123",
          "site_name": "Site 1",
          "external_id": "site1.com",
          "refresh_date": "2025-01-15",
          "question": "What is site1?",
          "locale": "EN-US",
          "chat_gpt_mentions": true,
          "chat_gpt_sentiment": "Positive",
          "competitor_mentions": "Competitor A, Competitor B"
        }
      ]
    }
  ],
  "all_questions": [
    // Flattened array of all questions from all sites
  ]
}

Flat JSON Format

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

Notes

  • Only includes target sites (not competitors)
  • Only includes sites with setup_complete: true
  • Sites ordered alphabetically by name
  • Field structure matches site-level questions endpoint

Still need help? Contact Us Contact Us