GET /sites/visibility

Returns appearance rates and ranking positions for each question across series.

Request

Endpoint

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

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"
    }
  ],
  "visibility": [
    {
      "question": "What is example?",
      "series_tracked": 5,
      "mentions": 3,
      "percent_mentioned": 60.0,
      "chat_gpt_rank": 1,
      "perplexity_rank": 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]_rank	integer	Rank position or null if not mentioned

Notes

Rank is the position where the site appears (1-based)
null indicates site not mentioned in that series
Percent calculations rounded to 1 decimal place