Search jobs and internships

Search indexed jobs and internships

curl --request GET \
  --url https://clair-job-search-api.p.rapidapi.com/v1/jobs \
  --header 'X-RapidAPI-Key: <api-key>'

const options = {method: 'GET', headers: {'X-RapidAPI-Key': '<api-key>'}};

fetch('https://clair-job-search-api.p.rapidapi.com/v1/jobs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://clair-job-search-api.p.rapidapi.com/v1/jobs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-RapidAPI-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://clair-job-search-api.p.rapidapi.com/v1/jobs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-RapidAPI-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://clair-job-search-api.p.rapidapi.com/v1/jobs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-RapidAPI-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "jobs": [
    {
      "posting_url": "<string>",
      "id": "fd6b984d-f7f4-4ca8-b68e-34b88a4ec299",
      "title": "Machine Learning Intern",
      "company": "Example Labs",
      "department": "Engineering",
      "team": "Applied AI",
      "location": "Berlin, Germany",
      "locations": [
        "<string>"
      ],
      "country": "DE",
      "employment_type": "Intern",
      "apply_url": "<string>",
      "posted_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "compensation": {
        "min": 25,
        "max": 35,
        "currency": "EUR",
        "interval": "hour",
        "summary": "<string>"
      },
      "title_family": "machine-learning engineer",
      "skills": [
        "Python",
        "PyTorch"
      ],
      "description_excerpt": "<string>",
      "description_available": true,
      "first_seen_at": "2023-11-07T05:31:56Z",
      "last_verified_at": "2023-11-07T05:31:56Z",
      "source": {
        "board": "examplelabs",
        "external_id": "4512338005"
      }
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "generated_at": "2023-11-07T05:31:56Z",
    "count": 25,
    "limit": 25,
    "has_more": true,
    "next_cursor": "<string>",
    "total": 123,
    "total_is_exact": true,
    "index": {
      "as_of": "2023-11-07T05:31:56Z",
      "active_boards": 123,
      "stale_boards": 123
    }
  }
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

GET

jobs

Search indexed jobs and internships

curl --request GET \
  --url https://clair-job-search-api.p.rapidapi.com/v1/jobs \
  --header 'X-RapidAPI-Key: <api-key>'

const options = {method: 'GET', headers: {'X-RapidAPI-Key': '<api-key>'}};

fetch('https://clair-job-search-api.p.rapidapi.com/v1/jobs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://clair-job-search-api.p.rapidapi.com/v1/jobs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-RapidAPI-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://clair-job-search-api.p.rapidapi.com/v1/jobs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-RapidAPI-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://clair-job-search-api.p.rapidapi.com/v1/jobs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-RapidAPI-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "jobs": [
    {
      "posting_url": "<string>",
      "id": "fd6b984d-f7f4-4ca8-b68e-34b88a4ec299",
      "title": "Machine Learning Intern",
      "company": "Example Labs",
      "department": "Engineering",
      "team": "Applied AI",
      "location": "Berlin, Germany",
      "locations": [
        "<string>"
      ],
      "country": "DE",
      "employment_type": "Intern",
      "apply_url": "<string>",
      "posted_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "compensation": {
        "min": 25,
        "max": 35,
        "currency": "EUR",
        "interval": "hour",
        "summary": "<string>"
      },
      "title_family": "machine-learning engineer",
      "skills": [
        "Python",
        "PyTorch"
      ],
      "description_excerpt": "<string>",
      "description_available": true,
      "first_seen_at": "2023-11-07T05:31:56Z",
      "last_verified_at": "2023-11-07T05:31:56Z",
      "source": {
        "board": "examplelabs",
        "external_id": "4512338005"
      }
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "generated_at": "2023-11-07T05:31:56Z",
    "count": 25,
    "limit": 25,
    "has_more": true,
    "next_cursor": "<string>",
    "total": 123,
    "total_is_exact": true,
    "index": {
      "as_of": "2023-11-07T05:31:56Z",
      "active_boards": 123,
      "stale_boards": 123
    }
  }
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

{
  "error": "bad_cursor",
  "detail": "<string>"
}

Authorizations

X-RapidAPI-Key

string

header

required

Your RapidAPI subscription key. Also send the X-RapidAPI-Host shown on the listing.

Query Parameters

string

Case-insensitive substring query over the posting title. This filters matches; ordering remains controlled by sort.

Required string length: 1 - 200

company

string

Case-insensitive substring match against the normalized company name.

Required string length: 1 - 200

location

string

Case-insensitive substring match against any location listed by the posting.

Required string length: 1 - 200

country

string

ISO 3166-1 alpha-2 country code derived from the posting's location strings. Case-insensitive. A remote posting whose source names no country has a null country and does not match this filter.

Required string length: 2

Pattern: ^[A-Za-z]{2}$

workplace_type

enum<string>

Normalized workplace arrangement.

Available options:

remote,

hybrid,

onsite

seniority

enum<string>

Seniority derived from the title. Use intern for internships, co-ops, apprenticeships, working-student roles, and placements.

Available options:

intern,

entry,

mid,

senior,

staff,

principal,

executive

track

enum<string>

Career track derived from the title.

Available options:

ic,

management,

executive

department

string

Case-insensitive substring match against department or team.

Required string length: 1 - 200

skills_all

string

Comma-separated canonical skills, at most 25 entries and 1,000 characters. Every named skill must be present. Names are case-insensitive; an unsupported name returns unknown_skill.

Required string length: 1 - 1000

skills_any

string

Comma-separated canonical skills, at most 25 entries and 1,000 characters. At least one named skill must be present. Names are case-insensitive; an unsupported name returns unknown_skill.

Required string length: 1 - 1000

salary_min

number

Minimum requested compensation. A posting matches when its stated maximum is at least this value. currency is required. salary_interval defaults to year when a bound is present.

Required range: x > 0

salary_max

number

Maximum requested compensation. A posting matches when its stated minimum is at most this value. currency is required. If both bounds are sent, salary_min must not exceed salary_max.

Required range: x > 0

currency

string

Three-character compensation currency, normalized to uppercase. Required with salary_min or salary_max; sent alone, it filters postings by currency.

Required string length: 3

Pattern: ^[A-Za-z]{3}$

salary_interval

enum<string>

Compensation interval. Defaults to year when a salary bound is present.

Available options:

year,

hour,

month,

week,

day

ats

enum<string>

Advanced provenance filter: only postings from this applicant tracking system.

Available options:

greenhouse,

lever,

ashby,

smartrecruiters,

workday,

recruitee

board

string

Advanced provenance filter: exact board identifier within an ATS. Pair it with ats when a board name could be ambiguous.

Required string length: 1 - 300

posted_after

string<date-time>

Return postings whose publisher-supplied posting time is at or after this ISO 8601 instant. Postings without a publisher date do not match.

first_seen_after

string<date-time>

Return postings Clair first discovered at or after this ISO 8601 instant. Prefer this over posted_after for alerts and incremental discovery.

sort

enum<string>

default:posted_at

Newest-first ordering. posted_at uses the publisher time and falls back to first_seen_at when missing.

Available options:

posted_at,

first_seen_at

include_description

enum<string>

default:false

When true, return a plain-text description_excerpt capped at 2,000 characters. This does not return an archival or full description.

Available options:

true,

1,

yes,

false,

0,

no

include_total

enum<string>

default:false

When true, run an additional exact distinct-count query and return meta.total. Off by default to keep broad searches bounded.

Available options:

true,

1,

yes,

false,

0,

no

limit

integer

default:25

Results per page.

Required range: 1 <= x <= 100

cursor

string

Opaque meta.next_cursor from the previous page. A cursor is bound to the original filters and sort; changing either returns bad_cursor.

Required string length: 1 - 1024

Response

A cursor-paginated page of active, deduplicated postings.

jobs

object[]

required

Option 1
Option 2

Show child attributes

Get started

Endpoints

Search jobs and internships

Authorizations

Query Parameters

Response