Knowledge Base

Get Brand Facts

Changed on

Lists a website's brand facts, newest first, with offset paging. By default excludes facts generated by Oracle analysis; pass include_oracle=true to include them. Filter by pillar, review status (defaults to approved), source type, or unfiled=true for facts not under any published pillar. unfiled and pillar_id are mutually exclusive. Also available as the MCP tool get_brand_facts.

get/api/v1/knowledge-base/facts

Request

  • Base URL
    https://api.athenahq.ai
  • Auth
    API key in header x-api-key

Query parameters

website_idstring uuid required

The website whose Knowledge Base to read.

pillar_idstring uuid

Only facts filed under this pillar.

status'approved' | 'pending' | 'rejected'

Review-status bucket to list.

source_type'research' | 'response' | 'upload' | 'content_hub'

Only facts that entered through this source.

unfiled'true' | 'false'

When "true", only facts not filed under any published pillar. Mutually exclusive with pillar_id.

include_oracle'true' | 'false'

When "true", facts generated by Oracle analysis are included in the listing. Defaults to "false" (excluded).

limitinteger

Page size.

offsetinteger

Rows to skip.

Response

Successful response with one page of facts and the uncapped total

totalinteger required

Total facts matching the filters, ignoring paging.

Changes