Skip to main content
GET
Find companies by what they do and what they did

Authorizations

Authorization
string
header
required

SeedOps API key, created in the API dashboard.

Query Parameters

sort
enum<string>
Available options:
activities,
latest
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
minSignals
integer

Only companies with at least this many matching activities. Implies one activity per company.

Required range: 1 <= x <= 9007199254740991
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
limit
integer

Maximum signals to return, from 1 to 50. Defaults to 50. Usage counts only returned signals.

Required range: 1 <= x <= 50

Response

Success. The result is wrapped in a data property.