Get jobs

Get a paginated list of published jobs

curl --request GET \
  --url https://hirehive-testing-account.hirehive.com/api/v2/jobs

{
  "items": [
    {
      "id": 123,
      "title": "<string>",
      "location": "<string>",
      "state_code": "<string>",
      "country": {
        "name": "<string>",
        "code": "<string>"
      },
      "salary": "<string>",
      "description": {
        "html": "<string>",
        "text": "<string>"
      },
      "category": {
        "id": 123,
        "name": "<string>"
      },
      "type": {
        "type": "<string>",
        "name": "<string>"
      },
      "experience": {
        "type": "<string>",
        "name": "<string>"
      },
      "language": {
        "name": "<string>",
        "code": "<string>"
      },
      "published_date": "2023-11-07T05:31:56Z",
      "created_date": "2023-11-07T05:31:56Z",
      "hosted_url": "<string>",
      "compensation_tiers": [
        {
          "label": "<string>",
          "type": "none",
          "interval": "none",
          "currency_code": "<string>",
          "currency_symbol": "<string>",
          "min_value": 123,
          "max_value": 123,
          "information": "<string>"
        }
      ]
    }
  ],
  "meta": {
    "page_size": 123,
    "page": 123,
    "total_items": 123,
    "total_pages": 123,
    "has_next_page": true,
    "has_previous_page": true
  },
  "links": {
    "first": "<string>",
    "last": "<string>",
    "next": "<string>",
    "previous": "<string>"
  }
}

GET

api

jobs

Get a paginated list of published jobs

curl --request GET \
  --url https://hirehive-testing-account.hirehive.com/api/v2/jobs

{
  "items": [
    {
      "id": 123,
      "title": "<string>",
      "location": "<string>",
      "state_code": "<string>",
      "country": {
        "name": "<string>",
        "code": "<string>"
      },
      "salary": "<string>",
      "description": {
        "html": "<string>",
        "text": "<string>"
      },
      "category": {
        "id": 123,
        "name": "<string>"
      },
      "type": {
        "type": "<string>",
        "name": "<string>"
      },
      "experience": {
        "type": "<string>",
        "name": "<string>"
      },
      "language": {
        "name": "<string>",
        "code": "<string>"
      },
      "published_date": "2023-11-07T05:31:56Z",
      "created_date": "2023-11-07T05:31:56Z",
      "hosted_url": "<string>",
      "compensation_tiers": [
        {
          "label": "<string>",
          "type": "none",
          "interval": "none",
          "currency_code": "<string>",
          "currency_symbol": "<string>",
          "min_value": 123,
          "max_value": 123,
          "information": "<string>"
        }
      ]
    }
  ],
  "meta": {
    "page_size": 123,
    "page": 123,
    "total_items": 123,
    "total_pages": 123,
    "has_next_page": true,
    "has_previous_page": true
  },
  "links": {
    "first": "<string>",
    "last": "<string>",
    "next": "<string>",
    "previous": "<string>"
  }
}

Query Parameters

sort

string

Sortable fields: title, published_date. Default is published_date desc. Add desc to sort in descending order.

title

string

Filter jobs by title

types

enum<string>[]

Filter jobs by employment type

Available options:

full_time,

part_time,

contract,

temporary,

other,

internship,

volunteer

experiences

enum<string>[]

Filter jobs by experience level

Available options:

na,

intern,

entry_level,

mid_level,

senior

countries

string[]

Filter jobs by the 2 letter ISO code of the country eg. US, FR

states

string[]

Filter jobs by the 2 letter ISO code of the state eg. FL, MA

category_ids

integer<int32>[]

Filter jobs by category id

published_after

string<date-time>

Filter jobs published after a specific date

published_before

string<date-time>

Filter jobs published before a specific date

page

integer<int32>

required

Defaults to 1

page_size

integer<int32>

required

Defaults to 30. Min = 1. Max = 100

Required range: 1 <= x <= 100

source

string

The source of the view/application that will be attributed in reports. Default CareerSite

Response

Jobs = An array of jobs, PublishedJobsCount = Count of the current published jobs, NextPage = A URL for the next page of results if more exist

items

object[] | null

required

Show child attributes

items.id

integer<int32>

The id of the job, format job_abc123.

items.title

string | null

items.location

string | null

items.state_code

string | null

items.country

object

Show child attributes

items.country.name

string | null

items.country.code

string | null

items.salary

string | null

items.description

object

Show child attributes

items.description.html

string | null

items.description.text

string | null

items.category

object

Show child attributes

items.category.id

integer<int32>

The id of the category, format cat_abc123.

items.category.name

string | null

items.type

object

Show child attributes

items.type.type

string | null

items.type.name

string | null

items.experience

object

Show child attributes

items.experience.type

string | null

items.experience.name

string | null

items.language

object

Show child attributes

items.language.name

string | null

items.language.code

string | null

items.published_date

string<date-time>

The date the job was last published. This will be null if the job was never published.

items.created_date

string<date-time>

The date the job was created.

items.hosted_url

string | null

items.compensation_tiers

object[] | null

Show child attributes

items.compensation_tiers.label

string | null

Maximum string length: 1000

items.compensation_tiers.type

enum<string>

Available options:

none,

fixed_salary,

range_salary

items.compensation_tiers.interval

enum<string>

Available options:

none,

hour,

day,

week,

month,

year

items.compensation_tiers.currency_code

string | null

Maximum string length: 3

items.compensation_tiers.currency_symbol

string | null

items.compensation_tiers.min_value

number<double> | null

items.compensation_tiers.max_value

number<double> | null

items.compensation_tiers.information

string | null

Maximum string length: 1000

Getting Started

Hosted careers page

Iframe

Public Jobs API

Query Parameters

Response