# SEEK Job

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/seek/job` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/seek-job |

## Description

Read one SEEK Australia job from its URL or numeric id.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/seek/job' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Telehealth Nurse

```json
{
  "id": "95568355",
  "url": "https://www.seek.com.au/job/95568355",
  "title": "Telehealth Nurse (RN or EN)",
  "salary": 45,
  "company": "Reorg Solutions",
  "currency": "AUD",
  "location": "Sydney NSW",
  "listed_at": null,
  "work_type": "Casual/Vacation",
  "salary_max": null,
  "salary_min": null,
  "description": "Telehealth Registered Nurse (RN) - Working With Veterans Casual Position | $45 Per Hour | Work From Home Initially Full-Time Hours | Monday to Friday, 9:00am–5:00pm - Subject to discussion and change to suit you. Veteran Experience Appreciated We are seeking a compassionate Registered Nurse (RN) to join our growing telehealth healthcare team supporting Australian veterans. This is a fully remote, casual position paying $45 per hour, initially offering full-time hours, Monday to Friday, 9:00am–5:00pm, to assist with clearing an existing backlog. Once the backlog has been addressed, ongoing hours will be determined by operational demand and workload requirements. There is potential for the position to transition into permanent part-time or full-time employment in the future, depending on business needs and suitability. About the Role You will provide support to patients via telehealth, working alongside a team of doctors and other healthcare professionals. The role involves patient communication, clinical support, triage, care coordination and following up on patient requests. Full training and ongoing support will be provided. This role would suit a nurse who is confident working independently, highly organised and comfortable working in a busy online healthcare environment. Key Responsibilities Conducting patient consultations via telehealth Taking accurate and detailed clinical notes during consultations Working with GPs and the wider clinical team Managing your own workload and working independently Managing appointment bookings and keeping the consultation schedule running smoothly Communicating professionally and compassionately with patients Managing upset, frustrated or distressed patients calmly and appropriately Identifying matters requiring escalation and referring to the appropriate member of the clinical team Following established clinical processes and procedures Providing a high standard of patient care and maintaining accurate documentation About You Current AHPRA registration as a Registered Nurse (RN) Strong communication and interpersonal skills Excellent organisation and attention to detail Comfortable working independently from home Confident using technology and online clinical systems Calm, professional and compassionate approach Experience working with veterans or within veteran healthcare is highly regarded What We Offer $45 per hour casual rate Initially full-time hours to assist with clearing an existing backlog Monday to Friday, 9:00am–5:00pm during the initial period Ongoing hours based on operational demand Potential to transition into permanent part-time or full-time employment Fully remote work from home Training provided Supportive clinical team Opportunity to work within a specialised veteran healthcare environment Requirements You will need: Current AHPRA registration as a Registered Nurse Your own reliable computer/laptop suitable for telehealth Reliable, high-speed internet A quiet and professional home workspace Availability to initially work Monday to Friday, 9:00am–5:00pm Flexibility regarding ongoing hours as operational needs change If you are a Registered Nurse looking for a casual work-from-home opportunity with the potential for permanent employment, and are passionate about providing quality healthcare to veterans, we would love to hear from you. Apply with your resume and a brief cover letter outlining your nursing experience and interest in the role.",
  "salary_period": "hour",
  "classification": "Nursing - General Medical & Surgical (Healthcare & Medical)",
  "salary_display": "$45 per hour"
}
```

## Documentation

## Overview
Read one SEEK Australia job. Send `results[].url` from search, or the numeric job id such as `95568355`. The response is a flat object with the same id, the advertiser, location, work type, classification, salary label, and description.

`salary` follows the same rule as search: a single amount, including `$45 per hour`, fills `salary`. A range fills `salary_min` and `salary_max`. The classification on the job page is one string, such as `Nursing - General Medical & Surgical (Healthcare & Medical)`, while search splits classification and subclassification.

## Quickstart
```
GET https://api.piloterr.com/v2/seek/job?query=95568355
GET https://api.piloterr.com/v2/seek/job?query=https://www.seek.com.au/job/95568355
```
`query` is required. A keyword that is not all digits returns 400. The host must be seek.com.au.

## Parameters
| Parameter | Required | Example |
|---|---|---|
| `query` | yes | `95568355` |

## Response fields
| Field | Type | Meaning |
|---|---|---|
| `id` | string | Same id as the search card |
| `url` | string | Job URL |
| `title` | string or null | Job title |
| `company` | string or null | Advertiser |
| `location` | string or null | Location |
| `work_type` | string or null | Work type, such as `Casual/Vacation` |
| `classification` | string or null | Classification line on the job page |
| `listed_at` | string or null | Listing time when the page prints one |
| `description` | string or null | Job text |
| `salary_display` | string or null | Salary label |
| `salary` | number or null | Single amount |
| `salary_min` | number or null | Low end of a range |
| `salary_max` | number or null | High end of a range |
| `salary_period` | string or null | `hour`, `day`, `week`, or `year` |
| `currency` | string or null | `AUD` when the label uses `$` |

There is no `results` wrapper.

## Use cases
- Read the description of job `95568355` after search, and check that `id` and `title` match the card.
- Confirm `company` and `work_type` before contacting the advertiser.
- Store `classification` and `salary_display` in a labor-market table.

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing id, a host other than seek.com.au, or a value that is neither an id nor a job URL |
| `401` | Missing API key |
| `404` | The page had no job description |
| `500` | The fetch failed |

## Related endpoints
[SEEK Search](https://www.piloterr.com/library/seek-search)