Fastest-hiring companies in a segment
segment_hiring_rankingBest for: who is hiring fastest in a market, such as "which companies added the most sales roles in Berlin this week?". Returns: companies ranked by new roles over 7 days, each with boards, open roles, baseline weekly average, ratio and a spike flag, plus as_of and the method. Input tips: {"segment": {"function": "sales", "city": "berlin"}}, {"segment": {"ats": ["greenhouse"]}} or {"segment": {"companies": ["stripe.com"]}}; no segment ranks every company. A function or city segment is this week's leaderboard list (at most 50). Country and size are not filters. Needs: an API key with segment access; else subscription_required. Not for: one company's detail (use company_hiring_brief).
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": {
"limit": 20,
"segment": {
"ats": [
"greenhouse"
]
}
},
"name": "segment_hiring_ranking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Companies to return, fastest first. Default 50. | |
| segment | No | Which companies to rank. Leave it out to rank every company the history store reads. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| method | Yes | ||
| source | Yes | Who the data comes from, to cite and to check it against. | |
| segment | Yes | ||
| companies | Yes | ||
| thresholds | No | ||
| api_version | Yes | Date of this answer's shape; it changes only when a field is removed or changes meaning. | |
| plan_active_until | No | ||
| unavailable_filters | No |