Company hiring brief
company_hiring_briefBest for: what one company is hiring for and how fast, such as "what is Snap hiring for?" or "is Airbnb hiring faster this month?". Returns: open roles, shares remote and with a salary, top departments and countries, the 5 newest roles, and roles opened and closed over 7, 30 and 90 days and per week once the board has a day of history. The board token goes into watch_new_roles. Input tips: {"company": "https://snapchat.wd1.myworkdayjobs.com/snap"}, an "ats:slug" token or a company name. Not for: lists of individual jobs with filters, or people at the company.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company": "greenhouse:airbnb"
},
"name": "company_hiring_brief"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company | Yes | A careers page URL, an "ats:slug" token such as "greenhouse:airbnb", or a company name or domain such as "stripe.com". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ats | Yes | ||
| note | Yes | ||
| as_of | Yes | ISO 8601 time the data was published by its source or fetched from it. A cached answer keeps the time of its fetch. | |
| board | Yes | The ats:slug token; pass it to watch_new_roles to follow this board. | |
| newest | Yes | ||
| source | Yes | Who the data comes from, to cite and to check it against. | |
| weekly | No | Roles opened and closed per week (Monday dates, oldest first, up to 13), for boards the history store reads daily. | |
| company | Yes | ||
| velocity | Yes | Roles opened and closed over each window (7, 30 and, from the history store, 90 days), from daily reads of this board; a window starts no earlier than the first read, and the list is empty until the board has a day of history. | |
| countries | Yes | ||
| open_roles | Yes | ||
| api_version | Yes | Date of this answer's shape; it changes only when a field is removed or changes meaning. | |
| departments | Yes | ||
| history_days | Yes | Days of history kept for this board. | |
| remote_share | No | Share of open roles marked remote, 0 to 1. | |
| salary_share | No | Share of open roles that publish a salary, 0 to 1. | |
| hiring_velocity | No | Not in every answer. New roles per ISO week (Monday dates) for the company's tracked boards, each role once on the day its board says it was posted (Greenhouse, Lever, Ashby) or first seen: the last 7 days, the 4 newest weeks, 13 weeks, a trend and the percentile among tracked companies. Counts only roles still open or seen since the board was first read. Null when the history store does not track the board. | |
| untrusted_source | Yes |