List filters and values

GET

/api/v1/leads/filters

• Production

Cost: Free

Filter values must match the source’s spelling exactly — a near-miss returns zero rather than an error, so read the list rather than guessing. jobTitles/includeKeywords/excludeKeywords are free text and have no fixed list.

Try it

curl https://app.leadsonar.io/api/v1/leads/filters \
  -H "X-API-Key: $LS_KEY"

One filter’s values:

curl "https://app.leadsonar.io/api/v1/leads/filters?field=seniority" \
  -H "X-API-Key: $LS_KEY"

{
  "field": "seniority",
  "values": [
    {
      "value": "Staff",
      "count": "46030856"
    },
    {
      "value": "Manager",
      "count": "13846020"
    },
    {
      "value": "Cxo",
      "count": "5565033"
    },
    {
      "value": "Director",
      "count": "3555477"
    },
    {
      "value": "Vp",
      "count": "2096093"
    }
  ]
}

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

field

string

Allowed values: industry seniority country department company_size revenue

Omit to list the filter names; pass one to get that filter’s values.

Responses

200

Filter names, or the requested filter’s values

object

Example

{
  "filters": [
    "industry",
    "seniority",
    "country",
    "department",
    "company_size",
    "revenue",
    "companyType"
  ],
  "note": "Call again with ?field=<name> for that filter's values. jobTitles, excludeTitles, includeKeywords and excludeKeywords are free text and have no fixed list."
}