Remotive Job API Documentation

Terms of Services

Please note that API documentation and access is granted so that developers can share our jobs further. Please do not submit Remotive jobs to third Party websites, including but not limited to: Jooble, Neuvoo, Google Jobs, LinkedIn Jobs. Please link back to the URL found on Remotive AND mention Remotive as a source in order to Remotive to get traffic from your listing. If you don't do that, we'll terminate your API access, sorry! Jobs displayed are delayed by 24 hours, the goal being that jobs are attributed to Remotive on various platforms. Displaying our jobs in order to collect signups/email addresses to show a listing constitutes a breach of our terms of services. We offer a private, paid-for API, please email us at hello(at)remotive(dot)io for more information (starting budget is $5k/mo)


Requests Limit/Request Rate

Please note that there is absolutely no need to request Remotive Job data too frequently. Typically, you only need to GET Remotive job data through this API a couple of times a day (we advise max. 4 times a day). Our data is not changing much faster than that anyway. Note that excessive requests will be blocked.


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
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
                                        "job_type": "full_time", // "full_time" or "contract" here. It's optional an often not filled.
                                        "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. It's optional an often not filled.
                                        "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!