# Analyze recent hiring signals

Analyze a company's recent jobs for department and initiative signals, then return relevant senior people and ranked contact candidates. Each signal links to supporting job evidence.

- Platform: LinkedIn
- Request: `GET https://api.toolzerhub.com/v1/linkedin/company/hiring-trigger`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/linkedin/linkedin-company-hiring-trigger

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `company` | query | yes | string | Company name, LinkedIn company URL or handle, or website. |
| `company_id` | query | no | string | Numeric LinkedIn company id. Omit it to resolve the company first. |
| `keywords` | query | no | string | Words that fresh job titles and descriptions should match. |
| `location` | query | no | string | Place to restrict the job search to. |
| `geo_id` | query | no | string | Numeric geo id from /geo/typeahead for a precise location filter. |
| `date_posted` | query | no | enum: past_24_hours, past_week, past_month | How recently each returned job must have been posted. Default: past_week. |
| `job_limit` | query | no | integer | Maximum fresh jobs to include as evidence. Default: 5. |
| `detail_limit` | query | no | integer | Maximum jobs to read in full before deriving the signal. Default: 3. |
| `contact_limit` | query | no | integer | Maximum relevant decision-makers to return. Default: 5. |
| `department` | query | no | enum: engineering, sales, marketing, product, finance, people, data, operations, legal, support | Buying function to prioritize. Omit it to derive the function from the jobs. |
| `verify` | query | no | boolean | Check proposed addresses when the mail domain supports mailbox verification. Default: false. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/linkedin/company/hiring-trigger?company=<company>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.