List discovery runs
curl --request GET \
--url https://api.sigmora.org/v1/discovery/runs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sigmora.org/v1/discovery/runs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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,
"runs": [
{
"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"
}List discovery runs
List this workspace’s discovery runs.
GET
/
v1
/
discovery
/
runs
List discovery runs
curl --request GET \
--url https://api.sigmora.org/v1/discovery/runs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sigmora.org/v1/discovery/runs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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,
"runs": [
{
"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"
}Authorizations
A workspace API key.
Query Parameters
Only runs for this Brand. Get the id from GET /v1/brands → brands[].id; omit it for every Brand in the workspace.
Required string length:
1 - 200Example:
"brd_4b81"
How many runs to return. Between 1 and 100; defaults to 20.
Required range:
1 <= x <= 100