This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.
Developer keys need signals:read, or the complete legacy combination of companies:read. Signals scopes do not grant general CRM or Search access.
This reference describes the Signals discovery-monitor contract. Check the selected server’s capabilities and Signals catalog for supported sources, criteria, cadences and current billing. API availability does not enable monitoring or establish provider readiness, completed collection or delivered Signals.
This is a free static catalog lookup. For Job changes, copy label into criteria.industries. For LinkedIn posts, use the numeric id in criteria.authorsIndustryId; multiple IDs are comma-separated. These formats are intentionally different. Empty or missing industry filters do not request an industry restriction.
Query parameters
q· optionalstring
Case-insensitive label substring or exact numeric industry ID; maximum 100 characters. Empty returns suggested industries.
limit· optionalinteger
Number of options, 1–20; default 20.
| Name | Type | Description |
|---|---|---|
| q | string | Case-insensitive label substring or exact numeric industry ID; maximum 100 characters. Empty returns suggested industries. |
| limit | integer | Number of options, 1–20; default 20. |
Errors
| Status | Meaning |
|---|---|
| 401 | Missing or invalid authentication or organization/user context. |
| 403 | The developer key lacks one or more listed scopes. |
| 422 | Invalid query length or limit. |
