PHP Job Searching using Zip-Recruiter API

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.

Github: https://github.com/DoctorLai/ZipRecruiter

How to Use Zip Recruiter PHP Library?

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

1
2

$key = "APP_KEY";
$zip = new ZipRecruiter($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:

1

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

$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 of using PHP Job Search Library

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

<?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);
}

<?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);
}

Unit Tests

Unit tests are coming on the way… built on composer.

Live Example

The above sample has been integrated live: https://helloacm.com/software-engineering-jobs/

–EOF (The Ultimate Computing & Technology Blog) —