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.
APIv3Signal TemplatesParameters by template

Mentioned keywords on LinkedIn

Parameters, defaults and rules of the "Mentioned keywords on LinkedIn" signal template.

Detect when prospects post about the problems and technologies your product addresses.

Keymentioned-keywords-on-linkedin
Categorymarket
Watchesperson
SetupsDiscovery and account monitoring

Set this signal up with POST /v3/signal-setups: send the template's id as signal_template_id and the parameters below in parameters. Its id is in List signal templates. Any parameter not listed here is refused with a 422.

Parameters

ParameterTypeRequiredAllowed valuesDefaultDescription
scopesarray of stringYesdiscovery, account_monitoring (at least one)—Where the signal looks.
keywordsarray of stringYesAt least one keyword—The keywords to look for in posts.

Default is what the server stores when you leave the parameter out. — means there is no default: the parameter is required, or it is simply not set.

Rules

  • keywords has no default: you choose them.
  • Setting this signal up needs your persona to have at least one job title and one location, otherwise the request is refused with a 422. With several personas, send persona_id when you create the setup (see Create a signal setup).

Errors

A parameter that is missing, of the wrong type, or not an allowed value is refused with a 422 that names it under errors, for example parameters.scopes. These errors are specific to this signal template:

StatusCause
422parameters.keywords is missing or empty. Send at least one keyword.
409The signal template is archived.

Example

parameters of a setup:

{
  "scopes": ["discovery", "account_monitoring"],
  "keywords": ["data enrichment", "intent data"]
}

On this page