Get Hiring Signals
Fetch hiring signals (open job postings) with filtering, pagination, and search. Supports role-aware position filters, department and seniority filters, location targeting, team size, and applicant range filtering.
Authorizations
API key authentication. Include as Bearer token in Authorization header.
Query Parameters
Page number for pagination
x >= 1Number of results per page (maximum 100)
1 <= x <= 100Filter signals from this date (ISO 8601 format: YYYY-MM-DD)
Filter signals up to this date (ISO 8601 format: YYYY-MM-DD)
Relative date shorthand. Takes precedence over dateFrom/dateTo.
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
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).
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.
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.
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.
Comma-separated US state codes to filter by
Free-text search on hiring signal city, location, and region
Pipe-separated list of company industry categories to filter by
Comma-separated list of subcategory IDs to filter by
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)
Comma-separated list of departments to filter by (e.g., marketing, sales, engineering, product, design, operations, finance, people, data, customer_success, growth, legal)
Comma-separated list of seniority levels to filter by (e.g., founder, c_level, vp, director, head, lead, manager)
Comma-separated team size ranges (e.g., 1-10, 11-50, 51-200, 201-1000, 1000-plus)
Comma-separated applicant count ranges (e.g., 0-25, 26-50, 51-100, 101-200, 201-plus)
Search by company name (partial match, fuzzy). Prefer company_domain or company_linkedin_url for strict matching.
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.
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.
Field to sort by
date_posted, created_at, title, company_name, location Sort direction
asc, desc When set to "true", returns only pagination metadata with an empty data array. No credits are charged.
true 