Skip to content

Sources

The URLs AI answers cited, how they are classified, and which domains you watch. Beta: these shapes may change; see the changelog.

GET /audits/{auditId}/citations

How many URLs the current answers cited, the 10 most-cited domains with exact counts, and — with include=items — up to 100 of the URLs themselves, newest first.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/citations?verified=VERIFIED&include=INCLUDE" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
verifiedquerynostringtrue lists only sources whose URL was verified, any other value only unverified ones. Omit it for both.
includequerynostringitems adds up to 100 cited URLs, newest first. Without it the response carries only total and domains.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.totalintegeryes
data.domainsobject[]yesAt most 10, most cited first.
data.domains[].domainstringyes
data.domains[].countintegeryes
data.domains[].sampleUrlstringyes
data.itemsobject[]Only with include=items; at most 100.
data.items[].idstringyes
data.items[].auditIdstring
data.items[].answerIdstring
data.items[].urlstringyes
data.items[].normalizedUrlstring
data.items[].domainstringyes
data.items[].connectorTypestringyes
data.items[].verificationStartedAtstring | null
data.items[].verifiedAtstring | nullyesWhen the URL was checked; null until it is.
data.items[].httpStatusinteger | null
data.items[].resolvesboolean | null
data.items[].isRelevantboolean | null
data.items[].relevanceScorenumber | null
data.items[].verificationMethodstring | null
data.items[].sourceTypestring | nullWhat kind of site it is, as classified or overridden.
data.items[].createdAtstringyes
{
"success": true,
"data": {
"items": [
{
"id": "d0b67a7d-8670-47de-9bec-eab71915b3d0",
"auditId": "clrecorderaudit0000000001",
"answerId": "clrecorderanswer000000001",
"url": "https://rival.com/widgets",
"normalizedUrl": "https://rival.com/widgets",
"domain": "rival.com",
"connectorType": "OPENAI",
"verificationStartedAt": null,
"verifiedAt": null,
"httpStatus": null,
"resolves": null,
"isRelevant": null,
"relevanceScore": null,
"verificationMethod": null,
"sourceType": null,
"createdAt": "2026-10-26T19:53:04.861Z"
}
],
"total": 1,
"domains": [
{
"domain": "rival.com",
"count": 1,
"sampleUrl": "https://rival.com/widgets"
}
]
}
}

GET /audits/{auditId}/sources/overrides

The source types your organization set by hand — a host or path classified as a forum, a review site and so on. They apply to every audit in the organization.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/overrides" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.overridesSourceTypeOverride[]yes
data.maxintegeryesAlways 500.
{
"success": true,
"data": {
"overrides": [
{
"domain": "reviews.example.org",
"pathPrefix": "",
"sourceType": "review_site",
"updatedAt": "2026-10-26T19:53:05.381Z"
}
],
"max": 500
}
}

PUT /audits/{auditId}/sources/overrides

Classifies a host, host/path or URL as sourceType for every audit in the organization, replacing any override on the same target. Whether a site is the brand’s or a competitor’s is decided by the audit and cannot be overridden.

Terminal window
curl -X PUT "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/overrides" \
-H "Authorization: Bearer $BEKET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"<target>","sourceType":"<sourceType>"}'
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
targetstringyes
sourceType“forum” | “qa” | “review_site” | “directory” | “video” | “social” | “news” | “blog” | “reference” | “code” | “vendor” | “search_engine” | “other”yes
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.overrideSourceTypeOverrideyes
{
"success": true,
"data": {
"override": {
"domain": "reviews.example.org",
"pathPrefix": "",
"sourceType": "review_site",
"updatedAt": "2026-10-26T19:53:05.381Z"
}
}
}

DELETE /audits/{auditId}/sources/overrides

Removes the override on target. Removing one that does not exist succeeds.

Terminal window
curl -X DELETE "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/overrides?target=TARGET" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
targetqueryyesstringThe override to remove: a host, host/path or URL, as it was set.

GET /audits/{auditId}/sources/watch

The cited hosts this audit’s team pinned to keep an eye on.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/watch" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.watchesobject[]yes
data.watches[].domainstringyes
data.watches[].createdAtstringyes
data.maxintegeryesAlways 25.
{
"success": true,
"data": {
"watches": [
{
"domain": "rival.com",
"createdAt": "2026-10-26T19:53:05.398Z"
}
],
"max": 25
}
}

PUT /audits/{auditId}/sources/watch

Adds a host to the watch list. Watching one already watched succeeds.

Terminal window
curl -X PUT "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/watch" \
-H "Authorization: Bearer $BEKET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"<domain>"}'
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
domainstringyes
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.watchobjectyes
data.watch.domainstringyes
data.watch.createdAtstringyes
{
"success": true,
"data": {
"watch": {
"domain": "rival.com",
"createdAt": "2026-10-26T19:53:05.398Z"
}
}
}

DELETE /audits/{auditId}/sources/watch

Removes domain from the watch list. Removing one not watched succeeds.

Terminal window
curl -X DELETE "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/watch?domain=DOMAIN" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
domainqueryyesstringThe watched host to stop watching.
FieldTypeRequiredDescription
domainstringyes
pathPrefixstringyes
sourceType“forum” | “qa” | “review_site” | “directory” | “video” | “social” | “news” | “blog” | “reference” | “code” | “vendor” | “search_engine” | “other”yes
updatedAtstringyes