Brand Facts

GET /api/v1/brand-facts returns the workspace's fact knowledge base: the curated statements Brand FactCheck verifies claims against. One row is one atomic fact. Facts extracted from crawls or uploads land as proposed and only count for verification once a reviewer approves them to active; manually entered facts are active immediately.

Filters

Standard parameters (limit, offset, format=csv) work as described in Pagination, filtering, and errors.

Key fields

• fact_id: stable identifier
• statement: the fact itself, one atomic statement
• category: which part of the brand the fact describes
• source: how the fact entered the knowledge base (crawl, upload, or manual)
• source_url: the page the fact was extracted from, when it came from a crawl
• effective_date: when the fact became true, when known; useful for spotting outdated claims
• status: the fact's review state; only active facts participate in verification
• updated_at: when the fact was last edited or reviewed

Rows are ordered by updated_at descending with fact_id as the tiebreak, so offset pagination is stable.

Example

curl -H "Authorization: Bearer $AEO_API_KEY" \
  "https://app.citlyze.com/api/v1/brand-facts?status=active&category=pricing"

Use this resource to export the knowledge base for review, keep it in sync with internal documentation, and confirm which facts verification is actually using.