Skip to content

Facts

What the brand states about itself, to check AI answers against. Beta: these shapes may change; see the changelog.

GET /audits/{auditId}/facts

The current confirmed facts, the drafts waiting for a decision (newest first, at most 10 per key), and the keys the brand’s vertical expects that have no confirmed fact yet.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/facts" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.verticalstring | nullyesThe brand’s vertical; null reads as general.
data.gaps“claim” | “phone” | “address” | “hours” | “primary_category” | “service_area” | “headquarters” | “founded_year” | “founder” | “pricing_model” | “price_range” | “certification” | “offering”[]yesKeys the vertical expects with no confirmed fact.
data.confirmedBrandFact[]yes
data.draftsBrandFact[]yes
{
"success": true,
"data": {
"vertical": null,
"gaps": [
"claim",
"headquarters"
],
"confirmed": [],
"drafts": []
}
}

POST /audits/{auditId}/facts

Records a confirmed fact. For a key that holds one value, it replaces the current one, which stays in the history. Sending the current value again changes nothing and answers 200 with created: false.

Terminal window
curl -X POST "https://api.beket.ai/api/v1/audits/AUDIT_ID/facts" \
-H "Authorization: Bearer $BEKET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"factKey":"<factKey>","value":"<value>"}'
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
factKey“claim” | “phone” | “address” | “hours” | “primary_category” | “service_area” | “headquarters” | “founded_year” | “founder” | “pricing_model” | “price_range” | “certification” | “offering”yes
valuestringyes
sourceUrlstring | nullWhere the value is stated: an http(s) URL. Empty or null for none.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.factBrandFactyes
data.createdbooleanyes

POST /audits/{auditId}/facts/{factId}/confirm

Confirms a draft as it is, or — with a value — confirms your correction of it instead. Send {} to confirm it unchanged.

Terminal window
curl -X POST "https://api.beket.ai/api/v1/audits/AUDIT_ID/facts/FACT_ID/confirm" \
-H "Authorization: Bearer $BEKET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"value":"<value>"}'
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
factIdpathyesstringThe fact’s id.
FieldTypeRequiredDescription
valuestring
sourceUrlstring | nullWhere the value is stated: an http(s) URL. Empty or null for none.
FieldTypeRequiredDescription
successbooleanyes
dataBrandFactDecisionyes
{
"success": true,
"data": {
"fact": {
"id": "c47baa43-276c-45d4-93d5-09a3e26a7580",
"factKey": "claim",
"value": "Family owned since 1998",
"sourceUrl": null,
"origin": "places",
"state": "confirmed",
"decidedAt": "2026-10-26T19:53:05.425Z",
"supersededAt": null,
"createdByUserId": null,
"createdAt": "2026-10-26T19:53:05.421Z"
}
}
}

POST /audits/{auditId}/facts/{factId}/reject

Rejects a draft, or retracts a current confirmed fact. The value is kept as rejected, so no later draft brings it back.

Terminal window
curl -X POST "https://api.beket.ai/api/v1/audits/AUDIT_ID/facts/FACT_ID/reject" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
factIdpathyesstringThe fact’s id.
FieldTypeRequiredDescription
successbooleanyes
dataBrandFactDecisionyes
{
"success": true,
"data": {
"fact": {
"id": "0cbd0f1b-9921-4eb3-ac83-38789de11596",
"factKey": "claim",
"value": "Open 24 hours",
"sourceUrl": null,
"origin": "places",
"state": "rejected",
"decidedAt": "2026-10-26T19:53:05.437Z",
"supersededAt": null,
"createdByUserId": null,
"createdAt": "2026-10-26T19:53:05.433Z"
}
}
}

GET /audits/{auditId}/facts/history

Every value one key has held, newest first, 50 per page — replaced, rejected and current alike. Pass nextCursor back as cursor until it is null.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/facts/history?factKey=FACT_KEY&cursor=CURSOR" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
factKeyqueryyes“claim” | “phone” | “address” | “hours” | “primary_category” | “service_area” | “headquarters” | “founded_year” | “founder” | “pricing_model” | “price_range” | “certification” | “offering”The fact whose history to list.
cursorquerynostringOpaque cursor from a previous page’s nextCursor.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.factsBrandFact[]yes
data.nextCursorstring | nullyes
{
"success": true,
"data": {
"facts": [],
"nextCursor": null
}
}
FieldTypeRequiredDescription
idstringyes
factKey“claim” | “phone” | “address” | “hours” | “primary_category” | “service_area” | “headquarters” | “founded_year” | “founder” | “pricing_model” | “price_range” | “certification” | “offering”yes
valuestringyes
sourceUrlstring | nullyes
origin“user” | “places” | “claims_migration” | “inherited”yes
state“draft” | “confirmed” | “rejected”yes
decidedAtstring | nullyes
supersededAtstring | nullyesWhen a newer value replaced it; null while current.
createdByUserIdstring | nullyes
createdAtstringyes
FieldTypeRequiredDescription
factBrandFactyes