Sources
The URLs AI answers cited, how they are classified, and which domains you watch. Beta: these shapes may change; see the changelog.
List cited sources
Section titled “List cited sources”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.
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/citations?verified=VERIFIED&include=INCLUDE" \ -H "Authorization: Bearer $BEKET_API_KEY"Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | path | yes | string | The audit’s id. |
verified | query | no | string | true lists only sources whose URL was verified, any other value only unverified ones. Omit it for both. |
include | query | no | string | items adds up to 100 cited URLs, newest first. Without it the response carries only total and domains. |
Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object | yes | |
data.total | integer | yes | |
data.domains | object[] | yes | At most 10, most cited first. |
data.domains[].domain | string | yes | |
data.domains[].count | integer | yes | |
data.domains[].sampleUrl | string | yes | |
data.items | object[] | Only with include=items; at most 100. | |
data.items[].id | string | yes | |
data.items[].auditId | string | ||
data.items[].answerId | string | ||
data.items[].url | string | yes | |
data.items[].normalizedUrl | string | ||
data.items[].domain | string | yes | |
data.items[].connectorType | string | yes | |
data.items[].verificationStartedAt | string | null | ||
data.items[].verifiedAt | string | null | yes | When the URL was checked; null until it is. |
data.items[].httpStatus | integer | null | ||
data.items[].resolves | boolean | null | ||
data.items[].isRelevant | boolean | null | ||
data.items[].relevanceScore | number | null | ||
data.items[].verificationMethod | string | null | ||
data.items[].sourceType | string | null | What kind of site it is, as classified or overridden. | |
data.items[].createdAt | string | yes |
Example response (200)
Section titled “Example response (200)”{ "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" } ] }}List source-type overrides
Section titled “List source-type overrides”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.
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/overrides" \ -H "Authorization: Bearer $BEKET_API_KEY"Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | path | yes | string | The audit’s id. |
Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object | yes | |
data.overrides | SourceTypeOverride[] | yes | |
data.max | integer | yes | Always 500. |
Example response (200)
Section titled “Example response (200)”{ "success": true, "data": { "overrides": [ { "domain": "reviews.example.org", "pathPrefix": "", "sourceType": "review_site", "updatedAt": "2026-10-26T19:53:05.381Z" } ], "max": 500 }}Set a source-type override
Section titled “Set a source-type override”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.
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>"}'Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | path | yes | string | The audit’s id. |
Request body
Section titled “Request body”| Field | Type | Required | Description |
|---|---|---|---|
target | string | yes | |
sourceType | “forum” | “qa” | “review_site” | “directory” | “video” | “social” | “news” | “blog” | “reference” | “code” | “vendor” | “search_engine” | “other” | yes |
Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object | yes | |
data.override | SourceTypeOverride | yes |
Example response (200)
Section titled “Example response (200)”{ "success": true, "data": { "override": { "domain": "reviews.example.org", "pathPrefix": "", "sourceType": "review_site", "updatedAt": "2026-10-26T19:53:05.381Z" } }}Remove a source-type override
Section titled “Remove a source-type override”DELETE /audits/{auditId}/sources/overrides
Removes the override on target. Removing one that does not exist succeeds.
curl -X DELETE "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/overrides?target=TARGET" \ -H "Authorization: Bearer $BEKET_API_KEY"Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | path | yes | string | The audit’s id. |
target | query | yes | string | The override to remove: a host, host/path or URL, as it was set. |
List watched domains
Section titled “List watched domains”GET /audits/{auditId}/sources/watch
The cited hosts this audit’s team pinned to keep an eye on.
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/watch" \ -H "Authorization: Bearer $BEKET_API_KEY"Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | path | yes | string | The audit’s id. |
Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object | yes | |
data.watches | object[] | yes | |
data.watches[].domain | string | yes | |
data.watches[].createdAt | string | yes | |
data.max | integer | yes | Always 25. |
Example response (200)
Section titled “Example response (200)”{ "success": true, "data": { "watches": [ { "domain": "rival.com", "createdAt": "2026-10-26T19:53:05.398Z" } ], "max": 25 }}Watch a domain
Section titled “Watch a domain”PUT /audits/{auditId}/sources/watch
Adds a host to the watch list. Watching one already watched succeeds.
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>"}'Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | path | yes | string | The audit’s id. |
Request body
Section titled “Request body”| Field | Type | Required | Description |
|---|---|---|---|
domain | string | yes |
Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object | yes | |
data.watch | object | yes | |
data.watch.domain | string | yes | |
data.watch.createdAt | string | yes |
Example response (200)
Section titled “Example response (200)”{ "success": true, "data": { "watch": { "domain": "rival.com", "createdAt": "2026-10-26T19:53:05.398Z" } }}Stop watching a domain
Section titled “Stop watching a domain”DELETE /audits/{auditId}/sources/watch
Removes domain from the watch list. Removing one not watched succeeds.
curl -X DELETE "https://api.beket.ai/api/v1/audits/AUDIT_ID/sources/watch?domain=DOMAIN" \ -H "Authorization: Bearer $BEKET_API_KEY"Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | path | yes | string | The audit’s id. |
domain | query | yes | string | The watched host to stop watching. |
Schemas
Section titled “Schemas”SourceTypeOverride
Section titled “SourceTypeOverride”| Field | Type | Required | Description |
|---|---|---|---|
domain | string | yes | |
pathPrefix | string | yes | |
sourceType | “forum” | “qa” | “review_site” | “directory” | “video” | “social” | “news” | “blog” | “reference” | “code” | “vendor” | “search_engine” | “other” | yes | |
updatedAt | string | yes |