Remotive Job API Documentation

List Jobs

Returns the list of all active remote job listings on Remotive job board. Filtering is available using optional querystring parameters as described below. Remote job listings are sorted by publication date on Remotive job board.

URL endpoint for HTTP Request

GET https://remotive.io/api/remote-jobs

Optional Querystring Parameters

Following optional querystring parameters can be used to filter job listings.

Parameter Description Example
category Retrieve jobs only for this category. Category name or category slug must be provided here. Existing categories are available at this endoint. https://remotive.io/api/remote-jobs?category=software-dev
tags Retrieve jobs only for these tags. Tags slug must be provided here. Several tag can be provided (comma separated, e.g: php,ubuntu). Existing tags are available at this endoint. https://remotive.io/api/remote-jobs?tags=c-sharp,linux
tag_operator In case several tags are provided, they will be combined using this logical operator. Possible values:
  • or (default)
  • and
https://remotive.io/api/remote-jobs?tags=c-sharp,linux&tag_operator=and
company_name Filter by company name. Case insensitive, partial match ('ilike') will be used here to filter job listings based on provided company name. https://remotive.io/api/remote-jobs?company_name=remotive
search Search job listing title and description. Case insensitive, partial match ('ilike') will be used here to filter job listings. https://remotive.io/api/remote-jobs?search=front%20end
limit Limit the number of job listing results (default: all). An integer must be provided. https://remotive.io/api/remote-jobs?limit=5

Response

For example, the following request:

curl 'https://remotive.io/api/remote-jobs?limit=1'

Would return a JSON response with the following format:

{
  "0-legal-notice": "Remotive API Legal Notice",
  "job-count": 1, // Number or jobs matching the query == length of 'jobs' list
  "jobs": [ // The list of all jobs retrieved. Then for each job, you get:
    {
      "id": 123, // Unique Remotive ID
      "url": "https://remotive.io/remote-jobs/product/lead-developer-123", // Job listing detail url
      "title": "Lead Developer", // Job title
      "company_name": "Remotive", // Name of the company which is hiring
      "category": "Software Development", // See https://remotive.io/api/remote-jobs/categories for existing categories
      "tags": ["python", "back end"], // list of tags. See https://remotive.io/api/remote-jobs/tags for existing tags
      "job_type": "full_time",  // "full_time" or "contract" here
      "publication_date": "2020-02-15T10:23:26", // Publication date and time on https://remotive.io
      "candidate_required_location": "Worldwide", // Geographical restriction for the remote candidate, if any.
      "salary": "$40,000 - $50,000", // salary description, usually a yearly salary range, in USD.
      "description": "The full HTML job description here", // HTML full description of the job listing
    },
  ]
}

Have any questions about API? Please drop us an email! Or hit us up on Twitter!

Prefer using RSS Feeds?

We've got you covered! Check out the footer of our website with links to our feeds :)

Want to learn more about Remotive?

We're one of the largest Remote Work Community. Check out our vibrant Slack Community, read our Manifesto!