Skip to content
A Node.js package for getting job listings from Indeed.com.
JavaScript
Branch: master
Clone or download
Latest commit 641519a Jun 6, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Handle next page in multiple languages (#9) Jun 6, 2019
.gitignore Fix typo in readme Apr 10, 2019
LICENSE First commit Dec 24, 2016
README.md Fix typo in readme Apr 10, 2019
index.js Changed query to accept a queryOptions object Dec 26, 2016
package.json Release 3.0.2 Jun 6, 2019
yarn.lock Add yarn lock Jan 12, 2019

README.md

indeed-scraper

npm package

A Node.js package for getting job listings from Indeed.com

Installation

You can install using npm.

npm install indeed-scraper

Include the package

const indeed = require('indeed-scraper');

Query Indeed:

const queryOptions = {
  host: 'www.indeed.com',
  query: 'Software',
  city: 'Seattle, WA',
  radius: '25',
  level: 'entry_level',
  jobType: 'fulltime',
  maxAge: '7',
  sort: 'date',
  limit: 100
};

indeed.query(queryOptions).then(res => {
	console.log(res); // An array of Job objects
});

query() accepts a queryOptions object and returns a Promise of an array of Job objects.

  • queryOptions object:

    • host - string - The host to query. (country overview) - Default: 'www.indeed.com'
    • query - string - The text to search. (i.e. Software Developer) - Default: Empty String
    • city - string - The name of the city. Should be in the format 'Seattle, WA'. - Default: Empty String
    • radius - string - The search radius in miles - Default: '25'
    • level - string entry_level, mid_level, or senior_level - Default: Empty String
    • jobType - string - fulltime, contract, parttime, temporary, internship, commission - Default: Empty String
    • maxAge - string - The maximum age of jobs that are returned - Default: Empty String (No max age)
    • sort - string - relevance, date - Default: 'relevance'
    • limit - number - The maximum number of jobs to return - Default: 0 (No limit)
    • excludeSponsored - boolean - Exclude sponsored job postings from the results - Default: false
  • Job object:

    • title - string - Title of the job
    • company - string - Company Name
    • location - string - Location of the job
    • summary - string - Beginning of the job description
    • url - string - Url of the job page
    • postDate - string - A string describing how long ago the job was posted
    • salary - string - A string with salary information (can be empty)

Contributing

If you have an idea on how to improve this package, feel free to contribute!

  1. Clone or fork the repository
  2. Make changes
  3. Submit a pull request
You can’t perform that action at this time.