PHP Job Searching using Zip-Recruiter API

justyy(74)

Published in

#utopian-io

Words

222

Reading

1 min

Listen

Play

Introduction

The ZipRecruiter Search API enables our search Publisher partners to write software that works with ZipRecruiter’s elevated search product and display the best job search matches to job seekers on their site.

The ZipRecruiter Search API is a REST-ful API with all requests and responses sent over HTTPS and authenticated by the ‘api_key’ URL parameter. All API responses are returned with HTTP response codes used to denote success (2xx), client-caused failure (4xx), and server-caused failure (5xx). Responses are formatted as JSON.

This PHP library wraps the ZipRecruiter Search API and allows you to do some advanced job searches.

How to Use?

First, require the unit class.ziprecruiter.php and you can create the ZipRecruiter object by passing the APP_KEY.

$key = "APP_KEY";
$zip = new ZipRecruiter($key);

Then you can search the jobs by giving the paramter job name, location and job age to the Search method:

$zip->Search("Software Engineer", "London, UK", 25);

You then need to check if results are valid by method CheckResult. After that, you can filter the jobs by salary range FilterJobsBySalaryRange or industry FilterJobsByIndustry

Technology Stack

PHP 7.0 and composer unit test framework.

Demo

<?php
$key = "APP_KEY";
$zip = new ZipRecruiter($key);
$zip->Search("Software Engineer", "London, UK", 25);

if ($zip->CheckResult()) {
  echo "Total Jobs: " . $zip->GetTotalJobs(). "\n";
  $jobs = $zip->FilterJobsBySalaryRange(55000, 75000);
  foreach ($jobs as $job) {
    echo "Job ID: " . $job->id . "\n";
    echo "Company: " . $job->hiring_company->name . "\n";
    echo "Salary Min Annual: " . $job->salary_min_annual . "\n";
    echo "Salary Max Annual: " . $job->salary_max_annual . "\n";
    echo "Job URL: " . $job->url . "\n";
    echo "Published: " . $job->job_age . " days ago.\n";
  }  
  echo count($jobs);
  $jobs = $zip->FilterJobsByIndustry("Technology", $jobs);
  echo "Total Technology jobs: " . count($jobs);
}