---
title: "Aggregate hiring signals for a company's board"
method: GET
path: "/jobs/hiring-signals"
tags: ["Jobs"]
---

# Aggregate hiring signals for a company's board

`GET /jobs/hiring-signals`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/jobs/hiring-signals`
- Auth: API key in header `x-api-key`

Aggregates a company's ATS board into a hiring snapshot: total open roles, breakdowns by department/location/title, remote share, and how many roles are new in the last 7/30 days — a leading indicator of company growth. Supply provider plus that provider's slug params (token / company / org / tenant+datacenter+site / domain). Breakdowns are computed over the fetched postings.

## Query parameters

- `provider` 'greenhouse' | 'lever' | 'ashby' | 'workday' | 'smartrecruiters' | 'workable' | 'recruitee' | 'rippling' | 'personio' | 'teamtailor' | 'oracle' | 'ukg' | 'icims' | 'eightfold' | 'gem' | 'pinpoint', required
- `token` string
- `company` string
- `org` string
- `tenant` string
- `datacenter` string
- `site` string
- `host` string
- `board` string
- `domain` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- JobsSignalsResponseDoc
  - `code` integer
  - `data` JobsHiringSignals
    - `as_of` string: Time the snapshot was taken, in UTC (RFC 3339).
    - `by_department` JobsCount[]: Open roles per department, largest first, up to 20 entries.
      - `count` integer: Number of open roles with that name.
      - `name` string: Department, location or job title being counted.
    - `by_location` JobsCount[]: Open roles per location, largest first, up to 20 entries.
      - `count` integer: Number of open roles with that name.
      - `name` string: Department, location or job title being counted.
    - `company` string: Company or board identifier that was queried.
    - `new_last_30d` integer: Number of sampled roles posted in the last 30 days. Counts only postings with a usable posting date.
    - `new_last_7d` integer: Number of sampled roles posted in the last 7 days. Counts only postings with a usable posting date.
    - `provider` string: Applicant tracking system the board was read from, for example `greenhouse`.
    - `remote_count` integer: Number of sampled roles marked as remote.
    - `remote_pct` number: Share of sampled roles marked as remote, as a percentage rounded to one decimal.
    - `sampled_roles` integer: Number of postings the breakdowns below were computed from.
    - `source_url` string: URL the data was read from.
    - `top_titles` JobsCount[]: Most common job titles with their counts, up to 10 entries.
      - `count` integer: Number of open roles with that name.
      - `name` string: Department, location or job title being counted.
    - `total_open_roles` integer: Number of open roles on the board. Uses the provider's own total when it gives one.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)