API v3 is live and in beta: expect possible malfunctions and breaking changes in the coming days. If you find a bug, please report it to your Sillage contact.

Count a client's signal detections

Get the number of signal detections of a client's workspace that match your filters.

Returns the total number of signal detections of the named client that match the filters. It takes exactly the filters of Query a client's signal detections, in the same JSON body, without cursor and limit. Every filter is optional. Like a search, a count only covers the detections rated top priority, the ones shown in the app.

Route

POST/api/v3/partner/workspaces/{partner_workspace_id}/signals/count

Path parameters

ParameterTypeDescription
partner_workspace_idstringYour own ID for the client workspace, as you chose it at creation. URL-encode it in the path.

Body parameters

The filters of Query a client's signal detections, all optional: signal_date_from, signal_date_to, detected_at_from, detected_at_to, signal_setup_id, signal_run_id, signal_types, company_ids, company_domains, company_linkedin_handles, company_linkedin_urls, lead_id, countries and cities. The date and company rules are the same: see Dates and Company filters.

Example request

curl -X POST "https://api.getsillage.com/api/v3/partner/workspaces/ws_123/signals/count" \
  -H "Authorization: Bearer $SILLAGE_MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"signal_types":["keyword_detection"],"signal_date_from":"2026-09-01T00:00:00Z"}'

Success response

Status: 200 OK

{
  "data": {
    "total": 42
  }
}

Response fields

FieldTypeDescription
data.totalintegerNumber of signal detections matching the filters.

Errors

StatusMeaning
401The master key is missing or invalid.
404No workspace found for this partner_workspace_id.
422The body is not valid: an unknown field, a date without a time, a signal_date_from older than 180 days, an unknown value in signal_types, or a query parameter (this route takes none, and errors names the parameter). Also returned when partner_workspace_id is invalid. A range that ends before it starts (signal_date_from after signal_date_to or detected_at_from after detected_at_to) is refused with the code invalid_date_range; errors.signal_date_from says "must be on or before signal_date_to".
429Rate limit exceeded.
500An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json. type is always about:blank; code tells one problem from another, detail says what went wrong this time, and errors names the field at fault.

On this page