Jobs API endpoint
Returns a single Eightfold position with its full HTML/text description. id is the position id from a board listing; tenant/domain as in the board endpoint.
/jobs/eightfold/jobReturns a single Eightfold position with its full HTML/text description. Tries the newer PCSX detail endpoint first, falling back to the legacy SmartApply detail generation.
Query parameters:
tenant (required) — the Eightfold tenant subdomain (as in the board endpoint).domain (required) — the hiring organization's domain (as in the board endpoint).id (required) — the position id from a board listing.Returns a single Job object: provider, id, title, company, department, location, remote, workplace_type, employment_type, req_id, url, apply_url, posted_at, description_html, description_text, compensation, compensation_min, compensation_max, compensation_currency, compensation_period. company is the requested domain (falling back to tenant), since Eightfold never returns a per-position company/org name. Eightfold has no structured compensation field; the compensation_* fields are populated only when the description states an explicit pay figure near a salary/compensation keyword (many multinational tenants, e.g. Microsoft, state a separate figure per country — a USD one is preferred when present, otherwise the first valid figure found wins; many postings state no figure at all, in which case they stay empty).
| Field | In the sample | Value in the sample |
|---|---|---|
| provider | Has a value | “eightfold” |
| id | Has a value | |
| title | Has a value | “Critical Environment Electrical Engineer” |
| company | Has a value | “Microsoft” |
| company_logo_url | Has a value | google.com |
| department | Has a value | “Electrical Engineering” |
| location | Has a value | “United States, Arizona, Phoenix” |
| locations | Has a value | 2 entries |
| url | Has a value | apply.careers.microsoft.com |
| apply_url | Has a value | apply.careers.microsoft.com |
| req_id | Has a value | |
| description_html | Has a value | 10,201 characters |
| description_text | Has a value | 5,447 characters |
| compensation | Has a value | “USD 102100 – 202200” |
| compensation_min | Has a value | 102,100 |
| compensation_max | Has a value | 202,200 |
| compensation_currency | Has a value | “USD” |
| compensation_period | Has a value | “yearly” |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| tenant | string | Yes | Eightfold tenant subdomain | microsoft | |
| domain | string | Yes | Hiring organization domain | microsoft.com | |
| id | string | Yes | Eightfold position id from a board listing | 1970393556928891 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/jobs/eightfold/job?tenant=microsoft&domain=microsoft.com&id=1970393556928891" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"provider": "eightfold",
"id": "1970393556928891",
"title": "Critical Environment Electrical Engineer",
"company": "microsoft.com",
"department": "Electrical Engineering",
"location": "Phoenix, AZ, US",
"workplace_type": "onsite",
"req_id": "200043229",
"url": "https://apply.careers.microsoft.com/careers/job/1970393556928891",
"apply_url": "https://apply.careers.microsoft.com/careers/job/1970393556928891",
"posted_at": "2026-07-17T17:49:43Z",
"description_html": "<b>Overview</b><br><p>…</p>",
"description_text": "Overview …"
}
}Request schema
No body schema
Response schema
#/definitions/jobs.jobResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | jobs.Job | No | ||||
| data.ai_tools_mentioned | array | No | AITools lists canonical AI tool and platform names mentioned in the job title or description, such as "ChatGPT" or "GitHub Copilot". | |||
| data.apply_url | string | No | Link to the application page for the job. | |||
| data.benefits_mentioned | array | No | Benefits, Clearance, and Education contain canonical requirements and offerings mentioned in the job title or description. | |||
| data.company | string | No | Name of the hiring company. | |||
| data.company_logo_url | string | No | URL of the company's logo. | |||
| data.compensation | string | No | Compensation is the raw provider summary; the *Min/*Max/*Currency fields are parsed from it when the summary contains a recognizable pay range/amount. CompensationPeriod is the pay period ("hourly", "daily", "weekly", "monthly", "yearly") when the summary states one explicitly; empty when no period is stated (most single "$150K – $190K"-style ranges are implicitly annual but that is never asserted here). | |||
| data.compensation_currency | string | No | Currency code of the pay range, for example `USD`. | |||
| data.compensation_max | number | No | Upper end of the pay range stated in the posting. | |||
| data.compensation_min | number | No | Lower end of the pay range stated in the posting. | |||
| data.compensation_period | string | No | Pay period the posting states: `hourly`, `daily`, `weekly`, `monthly` or `yearly`. Omitted when the posting names none. | |||
| data.department | string | No | Department the job belongs to. | |||
| data.description_html | string | No | Job description as HTML. | |||
| data.description_text | string | No | Job description as plain text. | |||
| data.education_level_required | array | No | Education levels mentioned in the job title or description. | |||
| data.employment_type | string | No | Employment type the provider lists, such as full-time or contract. | |||
| data.id | string | No | Posting id within the provider. Use it with the provider's job endpoint. | |||
| data.location | string | No | Primary job location as the provider shows it. | |||
| data.location_city | string | No | LocationCity/State/Country are the structured components behind Location when the provider exposes them (or once the geo-enrich worker has resolved them from the free-text Location string) -- present only for the primary/first location, matching Location itself. | |||
| data.location_country | string | No | Country of the primary location. | |||
| data.location_state | string | No | State or region of the primary location. | |||
| data.locations | array | No | All locations listed for the job. | |||
| data.posted_age_text | string | No | Workday relative age ("Posted Today") | |||
| data.posted_at | string | No | RFC3339 / date when the provider gives one | |||
| data.provider | string | No | Applicant tracking system the posting comes from, for example `greenhouse` or `lever`. | |||
| data.remote | boolean | No | True when the posting is marked as remote. | |||
| data.req_id | string | No | Requisition id the company uses for the job. | |||
| data.security_clearance_required | array | No | Security clearances mentioned in the job title or description. | |||
| data.skills_mentioned | array | No | Skills lists canonical ESCO skill labels mentioned in the job title or description. | |||
| data.team | string | No | Team the job belongs to. | |||
| data.title | string | No | Job title as the company posted it. | |||
| data.url | string | No | Link to the job posting page. | |||
| data.workplace_type | string | No | Workplace arrangement the provider lists, such as remote, hybrid or on-site. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/jobs/eightfold/job?tenant=microsoft&domain=microsoft.com&id=1970393556928891" \
-H "x-api-key: $CRAWLORA_API_KEY"