API Documentation

The HireIntel API provides NASDAQ 100 hiring data as actionable hiring signals. Track job openings, detect hiring surges, compare companies, and uncover workforce trends -- all through a simple REST API.

Base URL

https://api.hireintel.ai

If you are using the HireIntel frontend, all API requests are proxied through /api for convenience -- no base URL needed.

Authentication

FREE

Free Tier

No API key required. Access market overviews, company stats, job search, and signal feeds.

curl https://api.hireintel.ai/market/overview

PRO

Pro Tier

Requires an API key passed via the X-API-Key header. Unlocks velocity analysis, skills breakdowns, company comparison, and historical trends.

curl -H "X-API-Key: your-key-here" \
  https://api.hireintel.ai/companies/AAPL/analysis

Error Responses

Status	Meaning
`401`	Missing or invalid API key on a Pro endpoint.
`403`	API key valid but lacks permission for the requested resource.
`429`	Rate limit exceeded. Wait and retry.

Rate Limits

Tier	Limit	Window
FREE	30 requests	per minute
PRO	100 requests	per minute

Rate limit information is returned in response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Free Endpoints

These endpoints are available to everyone without an API key.

GET/companiesFREE

List all tracked companies in the NASDAQ 100.

Parameters

Name	Type	Required	Description
`active_only`	boolean	No	Return only actively-scraped companies. Default: true.

GET/companies/{ticker}/statsFREE

Daily hiring statistics for a single company.

Parameters

Name	Type	Required	Description
`ticker`	string	Yes	Company ticker symbol (path parameter).
`days`	integer	No	Look-back window in days (7-365). Default: 30.

GET/market/overviewFREE

Market-level summary across all tracked NASDAQ 100 companies.

Parameters

No parameters required.

GET/market/signalsFREE

Top movers ranked by 7-day hiring growth rate.

Parameters

No parameters required.

GET/market/breakdownFREE

Aggregate job counts broken down by company, location, and topic.

Parameters

No parameters required.

Pro Endpoints

These endpoints require a valid X-API-Key header. Responses include deeper analytics, trend data, and hiring signals.

GET/companies/{ticker}/analysisPRO

Velocity metrics, trend analysis, and hiring signals for a company.

Parameters

Name	Type	Required	Description
`ticker`	string	Yes	Company ticker symbol (path parameter).
`days`	integer	No	Analysis window in days (7-365). Default: 30.

GET/companies/{ticker}/skillsPRO

Skills demand and department breakdown for a company.

Parameters

Name	Type	Required	Description
`ticker`	string	Yes	Company ticker symbol (path parameter).

GET/companies/comparePRO

Head-to-head comparison of up to 10 companies.

Parameters

Name	Type	Required	Description
`tickers`	string	Yes	Comma-separated ticker symbols (max 10). Example: AAPL,MSFT,GOOGL

GET/market/trendsPRO

Historical market-wide hiring analysis and trend data.

Parameters

Name	Type	Required	Description
`days`	integer	No	Look-back window in days (7-365). Default: 30.

Code Samples

Quick-start examples in Python, JavaScript, and cURL.

import requests

# --- Free tier (no API key needed) ---
resp = requests.get("https://api.hireintel.ai/market/overview")
data = resp.json()
print(f"Total openings: {data['total_openings']}")

# --- Pro tier (requires API key) ---
headers = {"X-API-Key": "your-key-here"}
resp = requests.get(
    "https://api.hireintel.ai/companies/AAPL/analysis",
    headers=headers,
    params={"days": 30},
)
analysis = resp.json()
print(f"Trend: {analysis['trend']['direction']}")
print(f"Signals: {len(analysis['signals'])}")

All responses are JSON. Timestamps follow ISO 8601 format in UTC. For questions or to request a Pro API key, reach out at api@hireintel.ai.