# Gloom Hiring Trends by Function

> Gloom Hiring Trends by Function is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.24/call, status unknown (last checked 2026-11-01).

Returns weekly hiring trend data by job function for a given stock ticker, including role counts and share metrics before and after a reference period.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/hiring/building?utm_source=zero.xyz
- Price: $0.24/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-hiring-trends-by-function-416e16d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vSVYpIhc9oedW6KJevr8H

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-hiring-trends-by-function-416e16d5
```

Example prompt: Pull the latest weekly hiring trend data for OKTA from Gloom, broken down by job function, so I can see how their sales and engineering headcount momentum is shifting.

## When to prefer this

Use this endpoint when you need alternative workforce/hiring data signals for publicly traded companies, particularly for equity research, factor models, or monitoring employment momentum shifts by job function. Prefer this over general job board scrapers when you want structured, ticker-aligned, week-over-week hiring trend analytics with before/after comparisons.

## Known failure modes

- Invalid or unsupported ticker symbol returns empty data array
- Missing required properties parameter may return malformed or empty response
- Payment failure (x402) prevents access to data
- Rate limiting or quota exhaustion returns 402 or 429 error
- Stale data if hiring signals haven't been updated for the requested week

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns a JSON array of hiring trend objects, each containing the stock ticker, company name, sector, job function label, a reference week date, role counts and hiring share for a 'before' period and a 'recent' period, along with raw value arrays for both windows.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "key": "sales",
    "name": "Okta, Inc.",
    "week": "2026-10-12",
    "label": "Sales",
    "before": {
     "roles": 17,
     "share": 0.147826086957,
     "total": 115,
     "weeks": 2,
     "values": [
      {}
     ]
    },
    "recent": {
     "roles": 45,
     "share": 0.384615384615,
     "total": 117,
     "weeks": 2,
     "values": [
      {}
     ]
    },
    "sector": "Technology",
    "symbol": "OKTA",
    "dimension": "function",
    "sourceTickers": [
     "OKTA"
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-hiring-trends-by-function-416e16d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)