Company Hiring Scan

Hiring signal for one company domain. Returns our indexed job data when the company is in our database; otherwise (or with live=1) live-scans the site - fingerprints the ATS, pulls the public board, and reports open-role count + recency velocity + a sample. Built for screening a CRM list for hiring momentum. 2 credits.

GEThttps://www.startuphub.ai/api/v1/companies/hiring-scan

Request

curl "https://www.startuphub.ai/api/v1/companies/hiring-scan?domain=ramp.com&live=1" \
  -H "Authorization: Bearer sk_live_..."

Parameters

domainstringrequired

Company domain or URL (also accepts url / website)

livebooleanoptionaldefault: false

Force a fresh live ATS scan even when DB data exists

Response

json

{
  "data": {
    "domain": "ramp.com",
    "in_database": true,
    "company": { "name": "Ramp", "slug": "ramp", "website": "https://ramp.com", "startuphub_url": "https://www.startuphub.ai/startups/ramp" },
    "hiring": {
      "source": "database",
      "ats_vendor": "greenhouse",
      "open_roles": 63,
      "roles_added_7d": 11,
      "roles_added_30d": 28,
      "sample": [{ "title": "Senior Software Engineer", "location": "New York", "is_remote": false }]
    }
  },
  "credits": { "cost": 2, "remaining_period": 9999, "remaining_balance": 1998 }
}

Errors

400Missing or invalid domain

401Invalid or missing API key

429Insufficient credits