Run discovery
curl --request POST \
--url https://api.sigmora.org/v1/discovery/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contentBrandId": "brd_4b81",
"kind": "discover"
}
'import requests
url = "https://api.sigmora.org/v1/discovery/runs"
payload = {
"contentBrandId": "brd_4b81",
"kind": "discover"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({contentBrandId: 'brd_4b81', kind: 'discover'})
};
fetch('https://api.sigmora.org/v1/discovery/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"run": {
"id": "<string>",
"contentBrandId": "<string>",
"configId": "<string>",
"kind": "discover",
"status": "queued",
"queryPlan": {
"version": "<string>",
"primaryThemeId": "<string>",
"themeIds": [
"<string>"
],
"seedTerms": [
"<string>"
],
"queries": [
{
"platform": "youtube_shorts",
"terms": [
"<string>"
],
"intents": [
"momentum"
]
}
],
"compiledAt": "2023-11-07T05:31:56Z",
"basis": [
"<string>"
],
"intent": "<string>",
"excludeKeywords": [
"<string>"
]
},
"result": {},
"error": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}Run discovery
Start the saved channel topic-monitor discovery or metric-refresh plan now. Returns the run at once with status running; poll GET /v1/discovery/runs/{runId} until it settles. One run per workspace at a time (409 while one is in flight) and a short per-plan cooldown (429 with Retry-After). Persists a run record before invoking collectors. Discovery saves a channel-owned topic snapshot from only matching observations; a partial provider failure is returned as partial with the successful source results retained, rather than erasing the run.
POST
/
v1
/
discovery
/
runs
Run discovery
curl --request POST \
--url https://api.sigmora.org/v1/discovery/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contentBrandId": "brd_4b81",
"kind": "discover"
}
'import requests
url = "https://api.sigmora.org/v1/discovery/runs"
payload = {
"contentBrandId": "brd_4b81",
"kind": "discover"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({contentBrandId: 'brd_4b81', kind: 'discover'})
};
fetch('https://api.sigmora.org/v1/discovery/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"run": {
"id": "<string>",
"contentBrandId": "<string>",
"configId": "<string>",
"kind": "discover",
"status": "queued",
"queryPlan": {
"version": "<string>",
"primaryThemeId": "<string>",
"themeIds": [
"<string>"
],
"seedTerms": [
"<string>"
],
"queries": [
{
"platform": "youtube_shorts",
"terms": [
"<string>"
],
"intents": [
"momentum"
]
}
],
"compiledAt": "2023-11-07T05:31:56Z",
"basis": [
"<string>"
],
"intent": "<string>",
"excludeKeywords": [
"<string>"
]
},
"result": {},
"error": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": "<string>",
"code": "invalid_request",
"details": "<unknown>",
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}Authorizations
A workspace API key.
Body
application/json
The Brand whose saved plan to run. Get it from GET /v1/brands → brands[].id.
Required string length:
1 - 200Example:
"brd_4b81"
discover finds new content; refresh rechecks metrics for known content. Defaults to discover.
Available options:
discover, refresh