Job Functions

On this page, we describe how to fetch jobs, both international and US. These functions return an array of jobs that follow the job schema.

Initializing the Job Functions

Initialization

  const {retrieveJobsUS, retrieveJobsInternational} = wrangle.jobFunctions;

Retrieve US Jobs

Parameters

  • Name
    search
    Type
    string
    Description

    Search parameter (eg: "software engineer").

  • Name
    location
    Type
    string
    Description

    City to search within.

  • Name
    radius_miles
    Type
    integer
    Description

    Radius from the city to search in miles. 100 works well.

  • Name
    days_ago
    Type
    integer
    Description

    Maximum days ago for a job posting. Pass null for default (recommended).

  • Name
    jobs_per_page
    Type
    integer
    Description

    Number of jobs to return. Any number greater than 250 will be rounded to 100.

  • Name
    page
    Type
    integer
    Description

    Increment this number over multiple calls with the same parameters to fetch more than 250 jobs in a search.

  • Name
    refine_by_salary
    Type
    integer
    Description

    Only show jobs with greater than this salary.

Call

  const jobs = await retrieveJobsUS(search, location, radius_miles, days_ago, jobs_per_page, page, refine_by_salary);

Response

  [
    Job: {
      // job schema
    },
    Job:{
      //...
    }...
  ]

Retrieve International Jobs

  • Name
    search
    Type
    string
    Description

    Search parameter (eg: "software engineer").

  • Name
    location
    Type
    string
    Description

    Country to search for. Keep in mind many have no jobs.

  • Name
    level
    Type
    string
    Description

    Level to search for ("All Levels", "Entry-level", "Mid-level", "Senior", "Manager", "Director", "Executive").

  • Name
    salary
    Type
    string
    Description

    Salary bucket to search for ("All Salaries", "$25,000+", "$50,000+", "$75,000+", "$100,000+", "$200,000+").

  • Name
    sorting
    Type
    string
    Description

    Sorting method for results ("Recency", "Relevance", "Salary").

Call

  const jobs = await retrieveJobsUS(search, location, level, salary, sorting);

Response

  [
    Job: {
      // schema as above
    },
    Job: {
      //...
    }...
  ]

Was this page helpful?