Zapier
Flat, polling-shaped reads for automation tools. The Beket Zapier app is built on these, and any integrator may use them. A per-key rate limit applies. Beta like the rest of the API, but the Zapier app depends on these shapes, so they change only by adding fields.
List audits for a picker
Section titled “List audits for a picker”GET /zapier/audits
Your organization’s live audits as id/label pairs, for a dropdown.
curl "https://api.beket.ai/api/v1/zapier/audits?limit=LIMIT" \ -H "Authorization: Bearer $BEKET_API_KEY"Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
limit | query | no | integer | Rows to return, newest first. Defaults to 100; a value above 100 is a 400. |
Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object[] | yes | |
data[].id | string | yes | |
data[].name | string | yes | |
data[].subject | string | yes | |
data[].mode | “brand” | “market” | yes |
Example response (200)
Section titled “Example response (200)”{ "success": true, "data": [ { "id": "clrecorderaudit0000000001", "name": "Example Co", "subject": "example.com", "mode": "brand" } ]}Identify the key’s organization
Section titled “Identify the key’s organization”GET /zapier/me
The organization this key belongs to, and the key’s name. Cheap and side-effect free: use it to test a connection.
curl "https://api.beket.ai/api/v1/zapier/me" \ -H "Authorization: Bearer $BEKET_API_KEY"Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object | yes | |
data.orgId | string | yes | |
data.orgName | string | yes | |
data.keyName | string | null | yes |
Example response (200)
Section titled “Example response (200)”{ "success": true, "data": { "orgId": "00000000-0000-4000-8000-00000000e001", "orgName": "Recorder Fixture", "keyName": "Recorder" }}List recently completed runs
Section titled “List recently completed runs”GET /zapier/runs
Completed runs with their headline numbers and a report link. Only the last 7 days are returned, newest first — poll it and dedupe on id. An auditId that is not a live audit of your organization is a 404, never an empty list, so a poll cannot silently watch nothing. Responses are Cache-Control: private, no-store.
curl "https://api.beket.ai/api/v1/zapier/runs?auditId=AUDIT_ID&limit=LIMIT" \ -H "Authorization: Bearer $BEKET_API_KEY"Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | query | no | string | Only this audit. A malformed id is a 400; an id that is not a live audit of your organization is a 404. |
limit | query | no | integer | Rows to return, newest first. Defaults to 50; a value above 100 is a 400. |
Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object[] | yes | |
data[].id | string | yes | The snapshot id — the event’s dedupe key. |
data[].auditId | string | yes | |
data[].auditName | string | yes | |
data[].subject | string | yes | The domain for a brand audit, the topic for a market audit. |
data[].runType | “full” | “short” | yes | |
data[].completedAt | string | yes | |
data[].aiVisibility | number | null | yes | |
data[].shareOfVoice | number | null | yes | |
data[].topCompetitors | string[] | yes | Competitor names, highest share first. |
data[].reportUrl | string | yes |
Example response (200)
Section titled “Example response (200)”{ "success": true, "data": [ { "id": "00000000-0000-4000-8000-00000000e102", "auditId": "clrecorderaudit0000000001", "auditName": "Example Co", "subject": "example.com", "runType": "full", "completedAt": "2026-10-25T19:53:04.851Z", "aiVisibility": 0.62, "shareOfVoice": 0.6, "topCompetitors": [ "Rival" ], "reportUrl": "https://app.beket.ai/audit/clrecorderaudit0000000001/report" } ]}List recent signals
Section titled “List recent signals”GET /zapier/signals
Signals first seen recently — a new competitor, a lost citation, a metric swing — flattened to one row each. Dismissed signals are left out. Only the last 7 days are returned, newest first — poll it and dedupe on id. An auditId that is not a live audit of your organization is a 404, never an empty list, so a poll cannot silently watch nothing. Responses are Cache-Control: private, no-store.
curl "https://api.beket.ai/api/v1/zapier/signals?auditId=AUDIT_ID&kind=KIND" \ -H "Authorization: Bearer $BEKET_API_KEY"Parameters
Section titled “Parameters”| Name | In | Required | Type | Description |
|---|---|---|---|---|
auditId | query | no | string | Only this audit. A malformed id is a 400; an id that is not a live audit of your organization is a 404. |
kind | query | no | “new_competitor” | “entity_disappeared” | “new_citation_source” | “metric_delta” | “edge_blocked_crawler” | Only signals of this kind. |
limit | query | no | integer | Rows to return, newest first. Defaults to 50; a value above 100 is a 400. |
Response
Section titled “Response”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | |
data | object[] | yes | |
data[].id | string | yes | |
data[].auditId | string | yes | |
data[].auditName | string | yes | |
data[].kind | “new_competitor” | “entity_disappeared” | “new_citation_source” | “metric_delta” | “edge_blocked_crawler” | yes | |
data[].kindLabel | string | yes | |
data[].title | string | yes | The same words the report shows for this signal. |
data[].firstSeenAt | string | yes | |
data[].state | “open” | “resolved” | yes | |
data[].reportUrl | string | yes |
Example response (200)
Section titled “Example response (200)”{ "success": true, "data": [ { "id": "clrecordersignal000000001", "auditId": "clrecorderaudit0000000001", "auditName": "Example Co", "kind": "new_competitor", "kindLabel": "New competitor", "title": "Rival started appearing in AI answers", "firstSeenAt": "2026-10-25T19:53:04.852Z", "state": "open", "reportUrl": "https://app.beket.ai/audit/clrecorderaudit0000000001/report?section=competitors" } ]}