Signals

Search Hiring Companies

The companies behind those postings, rolled up.

per_company_cap bounds how many of one company's postings count toward its score, so a company with 400 open roles does not drown the ranking.

post/hiring-signals/companies

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/hiring-signals/companies
  • 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 3 revisions of this API.