---
title: "Store the workspace's canonical business facts as AI ground truth."
method: POST
path: "/brand-facts"
---

# Store the workspace's canonical business facts as AI ground truth.

`POST /brand-facts`

## Request

- Base URL: `https://app.seomatic.ai/api/v1`
- URL: `https://app.seomatic.ai/api/v1/brand-facts`
- Auth: HTTP bearer

The owner's OWN declared business facts (name, founding year, contact, official profiles), used to detect AI answers that contradict them. One row per workspace, latest wins. Never page content or visitor data; keys outside the allowlist are dropped and each value is length-bounded.

## Request body

- object
  - `site` string: Site URL the facts describe.
  - `facts` object: Allowlisted keys: name, legal_name, founded, founders, description, email, phone, address, sameas.

## Response `200`

Stored

- object
  - `stored` boolean
  - `fields` integer

## Other responses

- `400`: Invalid JSON body

---

[API](https://skmtc.dev/seomatic/apis/seomatic-api.md) · [All operations](https://skmtc.dev/seomatic/apis/seomatic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seomatic/apis/seomatic-api/revisions/113a2a263604?raw)