---
title: "Search Brand Facts"
method: GET
path: "/api/v1/knowledge-base/facts/search"
tags: ["Knowledge Base"]
---

# Search Brand Facts

`GET /api/v1/knowledge-base/facts/search`

Semantic search over a website's approved brand facts. Combines vector similarity with full-text search, so it also reaches facts not filed under any pillar. Returns fact text with confidence, source URL and quote, and the published pillar it belongs to (null when unfiled). Also available as the MCP tool `search_brand_facts`.

## Query parameters

- `website_id` string, uuid, required
- `query` string, required
- `pillar_id` string, uuid
- `top_k` integer

## Response `200`

Successful response with matching facts, best matches first

- object
  - `facts` BrandFactSearchResult[], required
    - `id` string, uuid, required
    - `text` string, required — The fact statement.
    - `confidence` 'high' | 'medium' | 'low' | 'null', nullable, required — Confidence level assigned during ingestion, or null when unrated.
    - `source_url` string, nullable, required — URL the fact was extracted from, stored without protocol.
    - `source_quote` string, nullable, required — Verbatim quote from the source backing the fact.
    - `pillar` BrandFactPillar, nullable, required — The published pillar the fact is filed under, or null when the fact is unfiled.
      - `id` string, uuid, required
      - `name` string, required

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - No access to this website, or the Knowledge Base is not enabled for the organization

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/revisions/6c5d71622cb9/schema)