stackoverflow-careers

StackOverflow Careers API for Javascript applications.

An unofficial, maintained API to scrape the latest jobs from Stackoverflow Careers Jobs/RSS feeds. Unfortunately, due to limitations of the RSS feeds, only the latest 25 listings are available for any query. Make them more specific if you'd like deeper results.

Usage

Before use, make sure you install the library with the following command:

npm install stackoverflow-careers

Next, add the following into your Nodejs project:

const StackOverflow = require('stackoverflow-careers');

StackOverflow.getCareers({
        location: "london", // Location for the job. Making this more specific will yield better results.
        query: "contractor positions", // Any additional requirements, such as part time, contractor, startup etc.
        techLiked: ["javascript", "java", "c"], // Tech liked
        techDisliked: ["perl", "rust", "fortran"], // Tech disliked
        unit: "miles" // Unit of measurement.
    }, (jobs) => {
        jobs.forEach((job) => {
            console.log(job);
        });
});

JSDocs have been added to exposed API endpoints, any further issues please feel free to open up an issue on the Github repository

Changelog

v1.1 - Implemented HTML character encoding to allow searches contained special characters. This means you won't be receiving results for C when you search for C#. Nifty!

Contributing

• I've used the Airbnb ESLint configuration for this project and any pull requests that don't lint correctly under it will be rejected. If you're unsure how to install this specific config, I've written a guide here

• All exposed API endpoints must be fully JSDoc'd. An example can be seen here. In my experience this prevents a lot of issues being raised because people know what to expect :smile:

Outstanding issues

• I'm aware that the output for the main job listing is full of HTML tags. I'm looking for a way to solve this ASAP (read: not in the quickest, most horrendous way possible) and I'm open to suggestions.
• The output objects are a bit nasty. I'll clean these up in the next release (a few days time when I get the chance).