docs / enrich-hiring

Hiring Signals API

base /enrich-hiring/v13 endpoints

post/enrich-hiring/v1/hiring_signal6 credits

domain → company hiring snapshot: ATS provider + direct open-roles count, per-source counts (deduped), departments/seniority/remote-ratio/tech-signals, entity-confirm, honest snapshot intensity

Parameter		Allowed / range	Description
domain	optional	—	Company website domain (bare host like stripe.com; a full URL or leading www. is accepted and normalized). The ATS board slug is derived from the domain stem. Provide `domain` OR `company_name` (domain gives the strongest entity anchor).
company_name	optional	—	Company name, used when no domain is available (entity-match is weaker without a domain). Also seeds the ATS slug guess.
ats_slug	optional	—	Advanced: force the ATS board token/subdomain (skips slug auto-detect). Use when the board slug differs from the domain stem (e.g. a parent-company board).
ats_provider	optional	greenhouse · lever · ashby · workable	Advanced: force the ATS provider (skips the parallel probe). One of greenhouse / lever / ashby / workable.
countries	optional	—	Optional country hints for the keyword job sources (best-effort location filter; ATS count is global).

Try in playground →

post/enrich-hiring/v1/hiring_signal_rich10 credits

everything in hiring_signal + employer firmographics (linkedin company / glassdoor employer: industry, employee_count, HQ, founded, rating) which anchor a headcount-relative intensity (open-roles-to-headcount ratio)

Parameter		Allowed / range	Description
domain	optional	—	Company website domain (bare host like stripe.com; a full URL or leading www. is accepted and normalized). The ATS board slug is derived from the domain stem. Provide `domain` OR `company_name` (domain gives the strongest entity anchor).
company_name	optional	—	Company name, used when no domain is available (entity-match is weaker without a domain). Also seeds the ATS slug guess.
ats_slug	optional	—	Advanced: force the ATS board token/subdomain (skips slug auto-detect). Use when the board slug differs from the domain stem (e.g. a parent-company board).
ats_provider	optional	greenhouse · lever · ashby · workable	Advanced: force the ATS provider (skips the parallel probe). One of greenhouse / lever / ashby / workable.
countries	optional	—	Optional country hints for the keyword job sources (best-effort location filter; ATS count is global).

Try in playground →

post/enrich-hiring/v1/batch5 credits

hiring_signal for up to 10 domains in one call (cache-first, per-item ok/error)

Parameter		Allowed / range	Description
domains	required	—	Up to 10 domains (array or comma-separated). Each gets a hiring_signal snapshot; per-item ok/error, cache-first.

Try in playground →

Example request · hiring_signal

curl -X POST https://api.reefapi.com/enrich-hiring/v1/hiring_signal \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"domain":"stripe.com"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}