Companies

Get Companies Open Jobs

What are these CRM companies hiring for, right now?

A growth/buying signal: a company staffing up is a company with budget. Unrelated to /marketplace/job-posts, which publishes SDR roles you are recruiting for - both are called "jobs" but they share no data.

company_ids are mashup_companies.id values, NOT linkedin_company_id. Both are bare ints, so passing the wrong one addresses a different company rather than erroring.

Results split into items (resolved) and unresolved. An unresolved company is normal: it means the company could not be matched to a LinkedIn company page, not that it is not hiring. Read lcid_confidence before trusting a match - 1.0 is an exact LinkedIn-URL match, 0.7 is a domain fallback that can mismatch on shared or parked domains. open_jobs counts postings seen within window_days; the source carries no open/closed state, so a filled role lingers until it ages out.

Org isolation is by Postgres schema, so ids belonging to another org come back as unresolved with no existence disclosure. Owner-level RBAC (CompanyScopeFilter) is deliberately not applied: it reads user.permissions, which an API-key user does not carry, so wiring it in would resolve every API-key caller to scope "none" and return zero rows.

post/companies/open-jobs

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/companies/open-jobs
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

company_idsinteger[] required

CRM company IDs (mashup_companies.id) - NOT linkedin_company_id

window_daysinteger
include_postingsboolean

False = counts only (one CH query)

limit_per_companyinteger
include_subsidiariesboolean

Roll subsidiary postings into the parent. Off by default: one row = one company. NOTE: when true, jobs expands to child companies but open_jobs stays parent-only, so len(jobs) can exceed open_jobs.

Response

Successful Response

dataobject required

Changes

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