curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/global-scouts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/global-scouts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/global-scouts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Global scouts retrieved successfully"
},
"data": [
{
"_id": "6731c0a2b4e5f60718293a4b",
"organizationId": "66a0f1e2d3c4b5a697887766",
"name": "Hiring for data roles",
"type": "custom",
"applyTo": "watchlist",
"selectedCompanyIds": [],
"category": "Hiring",
"queryTemplate": "New job postings at the company for data engineering or analytics roles.",
"cadence": "weekly",
"effort": "medium",
"outputSchema": {
"type": "json",
"json_schema": {
"type": "object",
"properties": {
"signals": {
"type": "array"
}
}
}
},
"isActive": true,
"previewStatus": "completed",
"previewRunId": "trun_4b8e2f1a9c7d",
"previewData": null,
"metadata": {
"created": {
"at": "2026-10-02T08:15:00.000Z",
"by": "system"
},
"updated": {
"at": "2026-10-02T08:20:00.000Z",
"by": "system"
}
},
"signal_counts": {
"total": 12,
"new": 3
},
"latest_signal": {
"_id": "6735a9d1e2f3a4b5c6d7e8f9",
"scoutSchemaId": "6732d4e5f6a7b8c9d0e1f2a3",
"baseSchemaObjectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"category": "Hiring",
"scout_name": "Hiring for data roles",
"summary": "Northwind Traders posted three senior data engineer roles in Lisbon.",
"status": "new",
"detected_date": "2026-11-03T06:00:00.000Z",
"companyName": "Northwind Traders"
},
"active_company_count": 8
}
]
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}List workspace Scouts
Returns every workspace Scout, built-in and custom, sorted by category and then name. Each one carries its signal totals, its latest signal and how many companies it is running on.
The list is not paged: a workspace has a handful of Scouts.
A workspace Scout defines what to look for. The copies running on each company are company Scouts:
see List a company’s Scouts (GET /v1/platform/companies/{id}/scouts).
curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/global-scouts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/global-scouts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/global-scouts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Global scouts retrieved successfully"
},
"data": [
{
"_id": "6731c0a2b4e5f60718293a4b",
"organizationId": "66a0f1e2d3c4b5a697887766",
"name": "Hiring for data roles",
"type": "custom",
"applyTo": "watchlist",
"selectedCompanyIds": [],
"category": "Hiring",
"queryTemplate": "New job postings at the company for data engineering or analytics roles.",
"cadence": "weekly",
"effort": "medium",
"outputSchema": {
"type": "json",
"json_schema": {
"type": "object",
"properties": {
"signals": {
"type": "array"
}
}
}
},
"isActive": true,
"previewStatus": "completed",
"previewRunId": "trun_4b8e2f1a9c7d",
"previewData": null,
"metadata": {
"created": {
"at": "2026-10-02T08:15:00.000Z",
"by": "system"
},
"updated": {
"at": "2026-10-02T08:20:00.000Z",
"by": "system"
}
},
"signal_counts": {
"total": 12,
"new": 3
},
"latest_signal": {
"_id": "6735a9d1e2f3a4b5c6d7e8f9",
"scoutSchemaId": "6732d4e5f6a7b8c9d0e1f2a3",
"baseSchemaObjectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"category": "Hiring",
"scout_name": "Hiring for data roles",
"summary": "Northwind Traders posted three senior data engineer roles in Lisbon.",
"status": "new",
"detected_date": "2026-11-03T06:00:00.000Z",
"companyName": "Northwind Traders"
},
"active_company_count": 8
}
]
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}heliyos_scouts_list.Authorizations
A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.
Query Parameters
default for built-in Scouts only, custom for the Scouts you created.
default, custom Only Scouts with exactly this category (case-sensitive), up to 200 characters.
200true for running Scouts, false for paused Scouts and custom Scouts not yet confirmed.
Only Scouts with this scope. watchlist also matches older Scouts saved without a scope.
watchlist, selected_watchlist, entire_web Was this page helpful?

