Signals

Search Hiring Recruiters

The recruiters who posted the matching jobs.

Paged by recruiter_limit/recruiter_offset, INDEPENDENTLY of the companies paging: one recruiter can serve many companies, so the two counts diverge and paging one must not move the other.

post/hiring-signals/recruiters

Request

Base URL: https://be.graph8.com/api/v1
URL: https://be.graph8.com/api/v1/hiring-signals/recruiters
Auth: HTTP bearer

Headers

Authorizationstring nullable

X-Target-Org-Idstring nullable

Request body

keywordsstring[] required

Job-title keywords. OR semantics - any match counts.

window_daysinteger

How far back to look for postings.

location_containsstring nullable

Free-text token matched case-insensitively against the job location.

persona_senioritystring[] nullable

Decision-maker seniority filter.

persona_departmentstring[] nullable

Decision-maker department filter.

persona_title_containsstring nullable

Decision-maker title substring filter.

contacts_per_companyinteger

exclude_aggregatorsboolean

Drop postings from job-board aggregators. On by default because an aggregator is not a company that is hiring - it is a company that lists other people's jobs. /jobs/search/aggregators returns exactly what this suppressed, so a caller can audit it.

per_company_capinteger

Max postings counted per company.

parent_linkedin_company_idinteger nullable

Scope to one parent company and its subsidiaries. Omit to search everywhere.

limitinteger

Page size. Capped at 200 to bound the ClickHouse cost.

offsetinteger

include_recruitersboolean

Run the recruiter aggregation and enrichment hop. Set false to skip two round-trips when only Companies and Decision-makers are needed.

recruiter_limitinteger

Recruiter paging, INDEPENDENT of limit/offset: one recruiter can serve many companies, so the two counts diverge and a caller can page one tab without touching the other.

recruiter_offsetinteger

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.