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.
curl " https://api.beket.ai/api/v1/audits/AUDIT_ID/facts " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id.
Field Type Required Description successboolean yes dataobject yes data.verticalstring | null yes The 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”[] yes Keys the vertical expects with no confirmed fact. data.confirmedBrandFact []yes data.draftsBrandFact []yes
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.
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>"} '
Name In Required Type Description auditIdpath yes string The audit’s id.
Field Type Required Description factKey“claim” | “phone” | “address” | “hours” | “primary_category” | “service_area” | “headquarters” | “founded_year” | “founder” | “pricing_model” | “price_range” | “certification” | “offering” yes valuestring yes sourceUrlstring | null Where the value is stated: an http(s) URL. Empty or null for none.
Field Type Required Description successboolean yes dataobject yes data.factBrandFact yes data.createdboolean yes
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.
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 " \
Name In Required Type Description auditIdpath yes string The audit’s id. factIdpath yes string The fact’s id.
Field Type Required Description valuestring sourceUrlstring | null Where the value is stated: an http(s) URL. Empty or null for none.
"id" : " c47baa43-276c-45d4-93d5-09a3e26a7580 " ,
"value" : " Family owned since 1998 " ,
"decidedAt" : " 2026-10-26T19:53:05.425Z " ,
"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.
curl -X POST " https://api.beket.ai/api/v1/audits/AUDIT_ID/facts/FACT_ID/reject " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id. factIdpath yes string The fact’s id.
"id" : " 0cbd0f1b-9921-4eb3-ac83-38789de11596 " ,
"value" : " Open 24 hours " ,
"decidedAt" : " 2026-10-26T19:53:05.437Z " ,
"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.
curl " https://api.beket.ai/api/v1/audits/AUDIT_ID/facts/history?factKey=FACT_KEY&cursor=CURSOR " \
-H " Authorization: Bearer $BEKET_API_KEY "
Name In Required Type Description auditIdpath yes string The audit’s id. factKeyquery yes “claim” | “phone” | “address” | “hours” | “primary_category” | “service_area” | “headquarters” | “founded_year” | “founder” | “pricing_model” | “price_range” | “certification” | “offering” The fact whose history to list. cursorquery no string Opaque cursor from a previous page’s nextCursor.
Field Type Required Description successboolean yes dataobject yes data.factsBrandFact []yes data.nextCursorstring | null yes
Field Type Required Description idstring yes factKey“claim” | “phone” | “address” | “hours” | “primary_category” | “service_area” | “headquarters” | “founded_year” | “founder” | “pricing_model” | “price_range” | “certification” | “offering” yes valuestring yes sourceUrlstring | null yes origin“user” | “places” | “claims_migration” | “inherited” yes state“draft” | “confirmed” | “rejected” yes decidedAtstring | null yes supersededAtstring | null yes When a newer value replaced it; null while current. createdByUserIdstring | null yes createdAtstring yes