Skip to main content
GET
Get Hiring Signals

Authorizations

Authorization
string
header
required

API key authentication. Include as Bearer token in Authorization header.

Query Parameters

page
integer
default:1

Page number for pagination

Required range: x >= 1
limit
integer
default:20

Number of results per page (maximum 100)

Required range: 1 <= x <= 100
dateFrom
string<date>

Filter signals from this date (ISO 8601 format: YYYY-MM-DD)

dateTo
string<date>

Filter signals up to this date (ISO 8601 format: YYYY-MM-DD)

date_preset
enum<string>

Relative date shorthand. Takes precedence over dateFrom/dateTo.

Available options:
today,
yesterday,
last_7d,
last_14d,
last_30d,
last_60d,
last_90d,
last_6m,
last_1y,
last_2y,
this_week,
this_month,
this_quarter,
this_year,
last_week,
last_month,
last_quarter,
last_year

Free-text search across company name, industry, job title, location, and city

description
string

Full-text keyword search over the job description body only. Opt-in and separate from search — use it to find postings mentioning specific keywords, skills, or tools. Matches whole words (not substrings) and supports websearch-style syntax: space-separated terms are ANDed, "quoted phrases" match in order, and OR / leading - (exclude) are honored (e.g. kubernetes OR terraform -intern).

countries
string

Comma-separated list of country codes to filter by. Matches the job listing country OR the company HQ country. To match the job location only, use job_countries instead.

exclude_countries
string

Comma-separated list of country names or codes to EXCLUDE (denylist), e.g. China. A signal is excluded when EITHER the job-listing country or the company HQ matches; rows with a NULL field on a side are kept.

job_countries
string

Comma-separated country codes matching the job listing location ONLY (ignores company HQ). Use this to filter by where the job is, not where the company is based. Note: countries and job_countries are ANDed if both are supplied, so use one or the other, not both.

states
string

Comma-separated US state codes to filter by

city
string

Free-text search on hiring signal city, location, and region

categories
string

Pipe-separated list of company industry categories to filter by

subcategories
string

Comma-separated list of subcategory IDs to filter by

positions
string

Comma-separated list of positions to filter by (e.g., ceo, cto, cfo, coo, vp of engineering, head of product, engineering manager, product manager, founder, co-founder)

departments
string

Comma-separated list of departments to filter by (e.g., marketing, sales, engineering, product, design, operations, finance, people, data, customer_success, growth, legal)

seniorities
string

Comma-separated list of seniority levels to filter by (e.g., founder, c_level, vp, director, head, lead, manager)

team_size
string

Comma-separated team size ranges (e.g., 1-10, 11-50, 51-200, 201-1000, 1000-plus)

applicants
string

Comma-separated applicant count ranges (e.g., 0-25, 26-50, 51-100, 101-200, 201-plus)

company_name
string

Search by company name (partial match, fuzzy). Prefer company_domain or company_linkedin_url for strict matching.

company_domain
string

Recommended. Company website domain, e.g. novartis.com. Strict match — if no company has this domain the result is empty; never falls back to fuzzy name matching. Variants are equivalent: novartis.com, www.novartis.com and https://novartis.com/ all match the same company. Malformed values return 400. Takes priority over company_name; combined identifiers must agree or the result is empty.

company_linkedin_url
string

Recommended. LinkedIn company URL, e.g. linkedin.com/company/novartis. Strict match — if no company has this LinkedIn page the result is empty; never falls back to fuzzy name matching. http/https, optional www. and trailing slash are equivalent. Non-company LinkedIn URLs (e.g. personal /in/ profiles) return 400. Takes priority over company_name; combined identifiers must agree or the result is empty.

sort_by
enum<string>
default:created_at

Field to sort by

Available options:
date_posted,
created_at,
title,
company_name,
location
sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
count
enum<string>

When set to "true", returns only pagination metadata with an empty data array. No credits are charged.

Available options:
true

Response

Successful response with hiring signals

success
boolean
required
Example:

true

data
object[]
required
pagination
object
required
meta
object
required