> ## Documentation Index
> Fetch the complete documentation index at: https://careerk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Jobs API - Browse platform and scraped jobs

# Jobs API

The Jobs API provides public endpoints to browse both direct (platform) jobs and scraped external jobs.

## Base URL

```
http://localhost:3000/api/v1
```

## Endpoints Overview

| Method | Endpoint                | Description                |
| ------ | ----------------------- | -------------------------- |
| GET    | `/jobs`                 | List all jobs with filters |
| GET    | `/jobs/direct/{jobId}`  | Get direct job by ID       |
| GET    | `/jobs/scraped/{jobId}` | Get scraped job by ID      |
| POST   | `/jobs/bookmark`        | Bookmark a job             |
| GET    | `/jobs/bookmark`        | Get user's bookmarks       |
| DELETE | `/jobs/bookmarks/:id`   | Remove bookmark            |

## Query Parameters

| Parameter         | Type   | Default | Description                                     |
| ----------------- | ------ | ------- | ----------------------------------------------- |
| `source`          | string | `all`   | Filter by source: `direct`, `scraped`, or `all` |
| `page`            | number | 1       | Page number                                     |
| `limit`           | number | 20      | Results per page                                |
| `search`          | string | -       | Search in title/description                     |
| `jobType`         | enum   | -       | Filter by job type                              |
| `workPreference`  | enum   | -       | Filter by work preference (direct jobs only)    |
| `location`        | string | -       | Filter by location                              |
| `experienceLevel` | enum   | -       | Filter by experience level (direct jobs only)   |
| `salaryMin`       | number | -       | Minimum salary (direct jobs only)               |
| `salaryMax`       | number | -       | Maximum salary (direct jobs only)               |

## Job Source

| Source    | Description                                                 |
| --------- | ----------------------------------------------------------- |
| `direct`  | Jobs posted by companies on the platform                    |
| `scraped` | Jobs scraped from external sources (LinkedIn, Indeed, etc.) |

## Notes

* All job browsing endpoints are public (no authentication required)
* Bookmark endpoints require authentication (Job Seeker only)
* Direct jobs support more filters (workPreference, salary, experienceLevel)
* Scraped jobs have limited filters (jobType, location, search)
* For `/jobs?source=all`, results are merged and sorted by date

See detailed documentation for each endpoint in the API Reference section.