Skip to main content
GET
Count several named keyword searches at once

Authorizations

Authorization
string
header
required

SeedOps API key, created in the API dashboard.

Query Parameters

q
string

Words and quoted phrases in activity titles, all required. Put OR between alternatives, use -word or NOT word to exclude, and brackets to group. Terms of 1-3 letters or digits match whole words, longer terms match word starts, and *word matches inside words. Not semantic search.

Maximum string length: 1000
about
string

What companies say they do, using the same search rules as q. Example: "access control" OR "structured cabling".

Maximum string length: 1000
company
string

company

Maximum string length: 180
companySlug
string

companySlug

Maximum string length: 180
all
string

all

Maximum string length: 1000
exact
string

exact

Maximum string length: 180
any
string

any

Maximum string length: 1000
exclude
string

exclude

Maximum string length: 1000
country
string

Country names or two-letter codes, comma-separated. Example: United States,DE.

Maximum string length: 180
city
string

City names, comma-separated.

Maximum string length: 1000
excludeCountry
string

Leave out these countries, comma-separated.

Maximum string length: 1000
excludeIndustry
string

Leave out industries containing any of these words, comma-separated. Example: Staffing,Legal.

Maximum string length: 1000
poster
enum<string>

company or person: only activities posted by a company page, or only by a named person.

Available options:
company,
person
list
string

Only companies in one of your saved company lists.

Maximum string length: 40
industry
string

industry

Maximum string length: 180
size
string

Also --employees in the CLI. Company employee ranges written min-max, such as 5-300 (whole numbers up to 10000000); up to 4 comma-separated ranges.

Maximum string length: 80
days
string

Calendar-day lookback from 1 to 365, inclusive of the day N days ago. Explicit dateFrom/dateTo take precedence; not a rolling N-times-24-hour window.

Pattern: ^(?:[1-9]|[1-9]\d|[12]\d{2}|3[0-5]\d|36[0-5])$
dateRanges
enum<string>[]

dateRanges

Maximum array length: 4
Available options:
7,
30,
90,
older
dateFrom
string

dateFrom

Pattern: ^\d{4}-\d{2}-\d{2}$
dateTo
string

dateTo

Pattern: ^\d{4}-\d{2}-\d{2}$
category
string[]

Category IDs from seedops filters or GET /filter-options

Maximum array length: 30
Required string length: 1 - 180
hiringState
string

Hiring type; IDs from seedops filters or GET /filter-options, comma-separated for multiple selections

Maximum string length: 180
hiringFunction
string

Job function; IDs from seedops filters or GET /filter-options, comma-separated for multiple selections

Maximum string length: 180
hiringSeniority
string

Seniority; IDs from seedops filters or GET /filter-options, comma-separated for multiple selections

Maximum string length: 180
hiringEmployment
string

Employment type; IDs from seedops filters or GET /filter-options, comma-separated for multiple selections

Maximum string length: 180
hiringWorkArrangement
string

Work arrangement; IDs from seedops filters or GET /filter-options, comma-separated for multiple selections

Maximum string length: 180
fundingStage
string

fundingStage

Maximum string length: 180
fundingCurrency
enum<string>

fundingCurrency

Available options:
USD,
EUR,
GBP
fundingMin
number

fundingMin

Required range: x >= 0
fundingMax
number

fundingMax

Required range: x >= 0
companies
string[]

companies

Maximum array length: 50
Required string length: 1 - 180
patient
boolean

Allow up to 2 minutes for a very broad question. Limited to 10 a minute.

cursor
string

Use nextCursor with exactly the same filters

Maximum string length: 512

Response

Success. The result is wrapped in a data property.