Name: Company Hiring Signals API: Open Roles, Hiring Trend
Brand: steadyscrape
SKU: api-steadyscrape-company-hiring-signals
Availability: InStock
Author: API Market

# Company Hiring Signals API

## Overview

The Company Hiring Signals API tells you whether a company is hiring, how fast and for which teams. `/v1/companies/hiring` finds the company's job board from a name, domain or board link and returns open roles, roles posted in the last 7, 30 and 90 days, weekly posting rate, change over time, top departments and locations, seniority and remote mix, salary disclosure and recent roles. `/v1/companies/profile` returns a company profile read from its website.

It is built for B2B sales and account-based marketing teams, investors, recruiters and market researchers who use hiring as a buying or growth signal. The profile adds company name, description, industry guess, logo, social links, contact emails and phones, address and founded year for up to 5 domains per call.

## Features

*   **Hiring volume**: open roles plus roles posted in the last 7, 30 and 90 days.
*   **Trend**: open role change over 1, 7, 30 and 90 days once history builds up.
*   **Team breakdown**: functions, departments, top locations, countries, seniority and workplace mix.
*   **Flexible input**: company name, domain or job board link, up to 3 per call.
*   **Company profile**: name, description, industry, logo, socials, contacts and address for up to 5 domains.
*   **Rate limit**: 1 request per second on Free, Starter and Business, 2 on Pro.

## Use Cases

*   **Sales prospecting**: prioritise accounts that are hiring fast in your buyer's team.
*   **Investment research**: track hiring momentum at private and public companies.
*   **Recruiting**: see which companies are growing engineering or sales.
*   **CRM enrichment**: add industry, logo, socials and hiring data to account records.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/steadyscrape/company-hiring-signals
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Company hiring signals

Returns hiring volume, trend, team and location breakdowns and recent roles for up to 3 companies.

**Method:** `GET`

**Endpoint:** `/v1/companies/hiring`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `company` | query | Company names, domains or job board links, comma separated. Up to 3 values. | string | Yes | - | - |
| `recent_roles` | query | How many recent open roles to include per company (0-10). | integer | No | `5` | 10 |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/company-hiring-signals/v1/companies/hiring?company=stripe.com&recent_roles=3' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "success": true,
  "endpoint": "companies.hiring",
  "count": 1,
  "partial": false,
  "items": [
    {
      "input": "stripe.com",
      "resolvedVia": "directory",
      "matchConfidence": "high",
      "status": "ok",
      "statusDetail": null,
      "company": "Stripe",
      "atsPlatform": "greenhouse",
      "boardSlug": "stripe",
      "boardUrl": "https://job-boards.greenhouse.io/stripe",
      "openRoles": 715,
      "openRolesIsLowerBound": false,
      "postedLast7Days": 40,
      "postedLast30Days": 215,
      "postedLast90Days": 530,
      "postedDateCoverage": 1,
      "postingsPerWeekLast30Days": 50.2,
      "trend": "not_enough_history",
      "openRolesChange": {
        "1d": {
          "since": "2026-10-26",
          "from": 715,
          "to": 715,
          "change": 0,
          "changePct": 0
        },
        "7d": null,
        "30d": null,
        "90d": null
      },
      "openRolesChangeSinceTrackingStarted": {
        "since": "2026-10-26",
        "from": 715,
        "to": 715,
        "change": 0,
        "changePct": 0
      },
      "newRolesSinceLastSnapshot": 3,
      "closedRolesSinceLastSnapshot": 7,
      "newRolesLast7Days": null,
      "closedRolesLast7Days": null,
      "newRolesLast30Days": null,
      "closedRolesLast30Days": null,
      "hiringHighlights": [
        "25 Sales roles in Dublin, IE",
        "23 Sales roles in Chicago, US"
      ],
      "functions": [
        {
          "function": "Engineering",
          "openRoles": 180,
          "share": 0.252,
          "change": null
        },
        {
          "function": "Sales",
          "openRoles": 169,
          "share": 0.236,
          "change": null
        }
      ],
      "departments": [
        {
          "department": "Account Executives (EMEA)",
          "openRoles": 34
        },
        {
          "department": "General University",
          "openRoles": 25
        }
      ],
      "topLocations": [
        {
          "location": "Dublin, IE",
          "openRoles": 64
        },
        {
          "location": "San Francisco, US",
          "openRoles": 63
        }
      ],
      "countries": [
        {
          "countryCode": "US",
          "country": "United States",
          "openRoles": 340
        },
        {
          "countryCode": "IE",
          "country": "Ireland",
          "openRoles": 67
        }
      ],
      "countryCount": 22,
      "seniorityMix": {
        "INTERN": 15,
        "ENTRY": 33,
        "MID": 339,
        "SENIOR": 7,
        "LEAD": 67,
        "MANAGER": 206,
        "DIRECTOR": 17,
        "EXECUTIVE": 31
      },
      "seniorityShare": {
        "INTERN": 0.021,
        "ENTRY": 0.046,
        "MID": 0.474,
        "SENIOR": 0.01,
        "LEAD": 0.094,
        "MANAGER": 0.288,
        "DIRECTOR": 0.024,
        "EXECUTIVE": 0.043
      },
      "workplaceMix": {
        "remote": 110,
        "hybrid": 2,
        "onsite": 0,
        "unspecified": 603
      },
      "remoteShare": 0.154,
      "employmentTypes": {},
      "salaryDisclosedShare": 0,
      "salary": null,
      "recentRoles": [
        {
          "title": "Software Engineer, New Grad",
          "department": "General University",
          "function": "Engineering",
          "seniority": "ENTRY",
          "location": "Bangalore",
          "postedDate": "2026-10-28",
          "url": "https://stripe.com/jobs/search?gh_jid=8130876"
        },
        {
          "title": "Fraud Operations Analyst (CDMX)",
          "department": "SDC - Bridge RiskOps",
          "function": "Data & AI",
          "seniority": "MID",
          "location": "Mexico City",
          "postedDate": "2026-10-28",
          "url": "https://stripe.com/jobs/search?gh_jid=8168550"
        }
      ],
      "history": {
        "tracked": true,
        "trackedSince": "2026-10-26",
        "latestSnapshot": "2026-10-27",
        "snapshotDays": 2,
        "windowsAvailable": [
          "1d"
        ],
        "openRolesSeries": [
          {
            "date": "2026-10-26",
            "openRoles": 715,
            "new": null,
            "closed": null
          },
          {
            "date": "2026-10-27",
            "openRoles": 711,
            "new": 3,
            "closed": 7
          }
        ]
      },
      "dataNotes": [],
      "dataSource": "index",
      "boardFetchedAt": "2026-10-28T13:04:21Z",
      "indexRefreshedAt": "2026-10-28T14:21:01Z",
      "otherBoards": [],
      "reportGeneratedAt": "2026-10-29T04:49:24Z"
    }
  ],
  "meta": {
    "generatedAt": "2026-10-29T04:49:25.014Z",
    "tookMs": 4687,
    "version": "1.0.0"
  }
}
```

#### 2. Company profile

Returns a company profile read from its website for up to 5 domains: name, description, industry, logo, social links, contacts and address.

**Method:** `GET`

**Endpoint:** `/v1/companies/profile`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `domain` | query | Company domains, comma separated, for example stripe.com,notion.so. Up to 5 values. | string | Yes | - | - |
| `max_pages` | query | Pages read per domain (1-3). More pages find more details but take longer. | integer | No | `2` | 3 |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/steadyscrape/company-hiring-signals/v1/companies/profile?domain=stripe.com&max_pages=2' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "success": true,
  "endpoint": "companies.profile",
  "count": 1,
  "partial": false,
  "items": [
    {
      "position": 0,
      "input": "stripe.com",
      "domain": "stripe.com",
      "status": "ok",
      "note": null,
      "finalUrl": "https://stripe.com/",
      "redirectedToDomain": null,
      "pagesFetched": 2,
      "companyName": "Stripe",
      "nameSource": "schema.org",
      "legalName": "Stripe, LLC",
      "description": "Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.",
      "descriptionSource": "schema.org",
      "industryGuess": "Fintech / Payments",
      "industryConfidence": "medium",
      "industryCandidates": [
        "Fintech / Payments",
        "Developer tools / Cloud infrastructure"
      ],
      "industryKeywords": [
        "payments",
        "payment"
      ],
      "logoUrl": "https://images.stripeassets.com/fzn2n1nzq965/1hgcBNd12BfT9VLgbId7By/01d91920114b124fb4cf6d448f9f06eb/favicon.svg",
      "logoSource": "schema.org",
      "faviconUrl": "https://images.stripeassets.com/fzn2n1nzq965/1hgcBNd12BfT9VLgbId7By/01d91920114b124fb4cf6d448f9f06eb/favicon.svg",
      "ogImageUrl": "https://b.stripecdn.com/mkt-ssr-statics/assets/_next/static/media/stripe.37119086.jpg",
      "linkedinUrl": "https://www.linkedin.com/company/stripe",
      "xUrl": "https://x.com/stripe",
      "facebookUrl": "https://www.facebook.com/StripeHQ",
      "instagramUrl": "https://www.instagram.com/stripehq",
      "youtubeUrl": "https://www.youtube.com/@stripe",
      "githubUrl": "https://github.com/stripe",
      "tiktokUrl": null,
      "emails": [],
      "phones": [],
      "contactPageUrl": "https://stripe.com/contact/sales",
      "aboutPageUrl": "https://stripe.com/about",
      "streetAddress": null,
      "city": null,
      "region": null,
      "postalCode": null,
      "country": null,
      "addressFull": null,
      "addressSource": null,
      "foundedYear": null,
      "foundedSource": null,
      "employeesStated": null,
      "employeesSource": null,
      "techHints": [
        "Nginx",
        "Next.js"
      ],
      "techDetails": [
        {
          "name": "Nginx",
          "category": "Web server"
        },
        {
          "name": "Next.js",
          "category": "JS framework"
        }
      ],
      "language": "en-US",
      "schemaTypes": [
        "organization"
      ],
      "fetchedAt": "2026-10-29T04:50:16Z"
    }
  ],
  "meta": {
    "generatedAt": "2026-10-29T04:50:17.555Z",
    "tookMs": 4368,
    "version": "1.0.0"
  }
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request worked. The body has `success`, `endpoint`, `count`, `partial`, the `items` array and a `meta` block. |
| 400 | Bad Request | A required parameter is missing or a value is out of range. The body explains which parameter. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key has no active subscription to this API, or your plan quota is used up. |
| 404 | Not Found | The path is wrong. This API has two endpoints: `/v1/companies/hiring` and `/v1/companies/profile`. |
| 429 | Too Many Requests | You went over your plan's requests per second. The body has `retryAfterMs`, and `Retry-After` says how long to wait. |
| 500 | Internal Server Error | Something failed on the provider side. Retry once; if it keeps failing, contact us. |
| 503 | Service Unavailable | An upstream source is briefly unavailable. Retry after a short pause. |

## Rate Limits

Monthly quotas are 10 calls on Free, 500 on Starter, 1,600 on Pro and 4,000 on Business. The Free plan is a 7-day trial. Free and Starter allow 1 request per second, Pro allows 2 and Business allows 1, and each request counts as one call. Going over the per-second limit returns `429 Too Many Requests` with `retryAfterMs` in the body. Throttle your client, send requests one after another rather than in parallel on the lower plans, and honour the `Retry-After` header before retrying.

## FAQ

*   **Why is `trend` "not_enough_history"?**

    Trends need earlier snapshots of the company's board. They fill in as the company is tracked over the following days and weeks.

*   **What can I pass as `company`?**

    A company name, a domain such as `stripe.com` or a job board link, up to 3 separated by commas. `matchConfidence` says how sure the match is.

*   **What does `max_pages` do on the profile?**

    It sets how many pages of the company's website are read. More pages can find more contact and address details but take longer.

*   **How do I know which job board was used?**

    `atsPlatform` and `boardUrl` show the board the company was matched to, and `resolvedVia` says how it was found.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Is a company hiring, how fast and for which teams? Open roles, roles posted in the last 7 and 30 days, departments, locations and a company profile.

Company Hiring Signals API: Open Roles, Hiring Trend

Free

SteadyScrape

Starter

Business

Is a company hiring, how fast and for which teams? Open roles, roles posted in the last 7/30 days, top departments and locations, plus a company profile.