Skip to main content
GET
/
api
/
v2
/
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
meta
object