Skip to content

Latest commit

 

History

History
112 lines (78 loc) · 6.77 KB

README.md

File metadata and controls

112 lines (78 loc) · 6.77 KB

Looking to fill a remote job feed and want to use openings listed on Jobicy?

No problem! Our public API/RSS feeds can help you with that. Anyone can use the feed, all we ask is that you attribute the links back to Jobicy.com.

This API provides access to the latest 50 remote job listings from a diverse range of industries and companies. It’s a valuable resource for developers looking to integrate remote job data into their applications, websites, or research projects. Please read the guidelines and instructions below to understand how to effectively use the API.

To retrieve the latest 50 remote job listings, use the following API call:

GET https://jobicy.com/api/v2/remote-jobs
Query Parameters (optional):
  count - Number of listings to return (default: 50, range: 1-50)  
  geo - Filter by job region (default: all regions) 
  industry - Filter by job category (default: all categories)
  tag - Search by job title and description (default: all jobs)
  
Eg: https://jobicy.com/api/v2/remote-jobs?count=20&geo=usa&industry=marketing&tag=seo

Predefined query parameters: geo | industries

The API response is structured in JSON format with the following main components:

 "id": Unique Job ID,
 "url": Job link,
 "jobTitle": Job title,
 "companyName": Company name,
 "companyLogo": Company logo link,
 "jobIndustry": Job function (sector),
 "jobType": Job type (full-time, contract, part-time or internship)
 "jobGeo": Geographic restriction for employment (or Anywhere if not applicable), 
 "jobLevel": Seniority level (or Any if not applicable), 
 "jobExcerpt": Excerpt job description (max 55 characters), 
 "jobDescription": Full job description (HTML), 
 "pubDate": Publication date and time (UTC+00:00),
 "annualSalaryMin": Annual min salary (if applicable),
 "annualSalaryMax": Annual max salary (if applicable),
 "salaryCurrency": ISO 4217 salary currency code (if applicable)

API Calls Examples

Get the 20 latest remote jobs with the keyword "Python" from any region:

https://jobicy.com/api/v2/remote-jobs?count=20&tag=python

Get the 15 latest remote jobs from Canada:

https://jobicy.com/api/v2/remote-jobs?count=15&geo=canada

Get the 30 latest remote jobs in the Copywriting category from USA:

https://jobicy.com/api/v2/remote-jobs?count=30&geo=usa&industry=copywriting

Get the 10 latest remote jobs in the Customer Support category from any region:

https://jobicy.com/api/v2/remote-jobs?count=10&industry=supporting

In this manual, you will find the basic information regarding Jobicy’s RSS working principles and how to use it.
RSS (Really Simple Syndication) – is a web feed that allows users and applications to access updates to websites in a standardized, computer-readable format

Most of the jobs are for people from the Americas (USA, Canada and LATAM) and Europe/EMEA. Keep this in mind if your main audience is from other regions. You can find our public RSS feed here for all jobs posted:

RSS Feed: https://jobicy.com/?feed=job_feed

RSS Jobicy – This interface allows information to be received from the database jobicy.com. You do not need to know in detail how the base is constructed and from which table and field types it consists of. It is enough that API-request “knows” it. The request syntax and the type of data being returned are strictly determined by the service itself.

With this RSS, now you can build job apps with our data feed. Listings of jobs can be derived from the following endpoints:

RSS Url parameters:

 ?feed=job_feed (required)
 &job_categories=... (eg. supporting, dev, marketing..)
 &job_types=... (eg. full-time, freelance, contract..)
 &search_keywords=... (eg. designer)
 &search_region=... (eg. Canada, UK, USA, Europe)

Example query string:

https://jobicy.com/?feed=job_feed&job_categories=supporting&job_types=full-time&search_region=USA

Response: Full-time Customer Service jobs in the U.S. region.

What’s next?

You have now gotten acquainted with the basics of RSS Jobicy. The rest is up to you.

Of course, in real life, no one works with RSS in adjacent browser tabs. For this, different programming languages, SDK and code generators are used. The RSS working mechanism is very simple. The means of sending http-requests and handling responses from the server are practically provided in any environment. This means freedom of choice is constantly existent.

Fair Use and Restrictions

At Jobicy, we are thankful for your engagement with our Feeds and would like to provide some guidelines to ensure the best use of our resources:

  1. Appreciation for Integration: We are grateful for your incorporation of Jobicy Feeds into your projects.
  2. Primary Purpose of API/RSS Access: Our API/RSS access is primarily intended to facilitate the wider distribution of our job listings.
  3. Distribution Limitations: We request that our job listings not be distributed to external job platforms such as Jooble, Google Jobs, LinkedIn, and others.
  4. Publication Timing: To maintain our position as the original source, our job postings are intentionally published with a 6-hour delay.
  5. Access Frequency: Frequent polling for job data is unnecessary. Accessing the Feed a few times a day is sufficient, as our job information does not change more rapidly than this.
  6. Excessive Querying: Please be aware that excessive querying of our Feed may lead to restricted access.

We may implement restrictive measures and notify you and/or your service provider if:

  • you intentionally overload feeds (please limit feed checks to no more than once per hour);
  • you alter or misrepresent the content of the original response during import;
  • we determine that your actions are interfering with the functionality of our systems. We appreciate your cooperation and adherence to these guidelines to ensure a beneficial partnership.

IFTTT Applets

Automatically post new remote job on:
LinkedIn, Twitter, Facebook, Telegram, Slack, Discord and WordPress.