# Totaljobs Job Details API Documentation

<p><strong>Totaljobs Job Details</strong> reads one public job page by the numeric id returned by search. It joins the structured job data with the published job metadata to return the title, posting and expiry dates, employment type, industry, hiring organisation, geo coordinates with a GB address, numeric GBP salary with its unit, the long description, benefits, company profile text, apply flag, url and similar job ids.</p><p>The id passes unchanged from search. A salary the site calls competitive stays a raw text with a null number, never zero. A request costs 1 credit. A failed or missing job is not charged.</p>

- **Documentation:** [https://scrappa.co/docs/totaljobs-api/totaljobs_job](https://scrappa.co/docs/totaljobs-api/totaljobs_job)
- **API group:** Totaljobs API
- **Endpoint:** `GET https://scrappa.co/api/totaljobs/job/details`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | Yes | Numeric job id from search, for example 108334869. |

## Example response

```json
{
    "data": {
        "id": "108334869",
        "title": "Machine Learning Engineer",
        "salary": {
            "max": 85000,
            "min": 85000,
            "raw": null,
            "unit": "YEAR",
            "currency": "GBP"
        },
        "similar_ids": [
            "108334870"
        ]
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The job is no longer published. |
| 503 | Upstream Unavailable | The source could not be reached. The request is not charged. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
