---
title: "Search every job since April 2026 by title, company, country, seniority, employment type and posted date, or only jobs that list a salary."
method: GET
path: "/v1/jobs"
tags: ["Jobs and companies"]
---

# Search every job since April 2026 by title, company, country, seniority, employment type and posted date, or only jobs that list a salary.

`GET /v1/jobs`

## Request

- Base URL: `https://linkfetch.io`
- URL: `https://linkfetch.io/v1/jobs`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Search every job since April 2026 by title, company, country, seniority, employment type and posted date, or only jobs that list a salary.

1 credit per request, however many rows come back.

MCP tool: `search_jobs`.

## Query parameters

- `q` string
- `company` string
- `country` string[]
- `seniority` string[]
- `employment` string[]
- `posted` '24h' | '3d' | '7d' | '30d'
- `salary` '1'
- `limit` integer
- `page` integer
- `offset` integer

## Response `200`

OK

- object
  - `total` integer
  - `total_capped` boolean: True when total stopped counting at a cap.
  - `page` integer
  - `limit` integer
  - `data` JobListItem[]
    - `id` integer
    - `url` string, uri
    - `title` string
    - `company` object
      - `id` integer, nullable
      - `name` string, nullable
      - `logo_url` string, nullable
    - `location` string, nullable
    - `country_code` string, nullable
    - `posted_at` string, date-time, nullable
    - `seniority` string, nullable
    - `employment_type` string, nullable
    - `salary` object, nullable
      - `min` number, nullable
      - `max` number, nullable
      - `currency` string, nullable
      - `period` string, nullable
    - `applicant_count` integer, nullable

## Other responses

- `400`: Invalid input (`bad_request`).
- `401`: Missing, invalid or revoked API key (`unauthorized`).
- `402`: Out of credits (`out_of_credits`).
- `default`: Other errors: 409 account session needs attention, 428 no connected account (`no_account`), 501 not in the API yet (`coming_soon`), 502 LinkedIn failed (`upstream`), 503 `unavailable`, 500 `internal`.

---

[API](https://skmtc.dev/linkfetch/apis/linkfetch-api.md) · [All operations](https://skmtc.dev/linkfetch/apis/linkfetch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linkfetch/apis/linkfetch-api/revisions/b83d21f70fcb?raw)