Skip to main content
POST
Search new B2B prospects

Authorizations

X-API-Key
string
header
required

Your secret API key. Create it in OutReign → Settings → API Keys and send it on every request as X-API-Key: <key>. The key acts as its owner: every request reads and writes that owner's data. Keep it server-side; never ship it in browser or mobile code.

Body

application/json
query
string
Required string length: 1 - 500
job_title
string
Required string length: 1 - 500
industry
string
Required string length: 1 - 500
company_size
string
Required string length: 1 - 500
country
string
Required string length: 1 - 500
company
string
Required string length: 1 - 500
company_domain
string
Required string length: 1 - 500
seniority
string
Required string length: 1 - 500
job_titles
string[]
Maximum array length: 20
Required string length: 1 - 500
industries
string[]
Maximum array length: 20
Required string length: 1 - 500
countries
string[]
Maximum array length: 20
Required string length: 1 - 500
seniority_levels
string[]
Maximum array length: 20
Required string length: 1 - 500
keywords
string[]
Maximum array length: 20
Required string length: 1 - 500
exclude_titles
string[]
Maximum array length: 20
Required string length: 1 - 500
exclude_industries
string[]
Maximum array length: 20
Required string length: 1 - 500
exclude_keywords
string[]
Maximum array length: 20
Required string length: 1 - 500
strict
boolean
relax
boolean
exclude_seen
boolean
limit
integer

Further capped by plan: Starter 25, Growth 50, Pro 100, Agency 200.

Required range: 1 <= x <= 200
page
integer
Required range: 1 <= x <= 1000
cursor
string

Opaque next_cursor from prior response.

Required string length: 1 - 4000
companies
object[]
Maximum array length: 20

Response

App action result. Check error/error_code even on HTTP 200. Examples are illustrative, not actual customer results.

leads
object[]
next_cursor
string | null
has_more
boolean
error
string
error_code
string