indeed_api 0.0.1

data/lib/indeed_api/indeed_error.rb

@@ -0,0 +1,7 @@
+module IndeedAPI
+
+  class IndeedError < Exception
+
+  end
+
+end

data/lib/indeed_api/job.rb

@@ -0,0 +1,31 @@
+module IndeedAPI
+
+  class Job
+
+    attr_reader :job_title, :company, :city, :state, :country, :formatted_location,
+      :source, :date, :snippet, :url, :latitude, :longitude, :job_key, :sponsored,
+      :expired, :formatted_location_full, :formatted_relative_time
+
+    def initialize(data = {})
+      @job_title = data['jobtitle']
+      @company = data['company']
+      @city = data['city']
+      @state = data['state']
+      @country = data['country']
+      @formatted_location = data['formattedLocation']
+      @source = data['source']
+      @date = data['date'] ? Time.parse(data['date']) : nil
+      @snippet = data['snippet']
+      @url = data['url']
+      @latitude = data['latitude'] ? data['latitude'].to_f : nil
+      @longitude = data['longitude'] ? data['longitude'].to_f : nil
+      @job_key = data['jobkey']
+      @sponsored = data['sponsored'] == 'true'
+      @expired = data['expired'] == 'true'
+      @formatted_location_full = data['formattedLocationFull']
+      @formatted_relative_time = data['formattedRelativeTime']
+    end
+
+  end
+
+end

data/lib/indeed_api/version.rb

@@ -0,0 +1,5 @@
+module IndeedAPI
+
+  VERSION = '0.0.1'
+
+end

data/lib/indeed_api.rb

@@ -0,0 +1,65 @@
+
+require 'bundler/setup'
+require 'httparty'
+
+module IndeedAPI
+
+  autoload :IndeedError, File.dirname(__FILE__) + '/indeed_api/indeed_error'
+  autoload :Job, File.dirname(__FILE__) + '/indeed_api/job'
+
+  API_VERSION = 2
+
+  include HTTParty
+  base_uri 'http://api.indeed.com/ads'
+
+  # set your publisher ID - required
+  def self.publisher_id=(id)
+    @publisher_id = id
+  end
+
+  # get the publisher ID currently in use
+  def self.publisher_id
+    @publisher_id
+  end
+
+  # Search the API 
+  # Can specify options at https://ads.indeed.com/jobroll/xmlfeed
+  def self.search_jobs(options = {})
+    options.merge!(:publisher => self.publisher_id, :v => API_VERSION)
+    response = get('/apisearch', :query => options)
+    handle_errors(response)
+
+    return [] unless results = response['response']
+    return [] unless results = results['results']
+    return [] unless results = results['result']
+    results.is_a?(Hash) ? [IndeedAPI::Job.new(results)] : results.map { |jd| IndeedAPI::Job.new(jd) }
+  end
+
+  # Get an individual job - for convenience
+  def self.get_job(id)
+    jobs = get_jobs([id])
+    jobs.empty? ? nil : jobs.first
+  end
+
+  # Get a bunch of jobs at once
+  def self.get_jobs(*ids)
+    options = { :publisher => self.publisher_id, :jobkeys => ids.join(','), :v => API_VERSION }
+    response = get('/apigetjobs', :query => options)
+    handle_errors(response)
+
+    return [] unless results = response['response']
+    return [] unless results = results['results']
+    return [] unless results = results['result']
+    results.is_a?(Hash) ? [IndeedAPI::Job.new(results)] : results.map { |jd| IndeedAPI::Job.new(jd) }
+  end
+
+  private
+
+  # Throw errors if the response contains an error
+  def self.handle_errors(response)
+    error = response['response']['error']
+    raise Indeed::IndeedError.new(error) if error
+  end
+
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'lib/indeed_api'

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: indeed_api
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- John Crepezzi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-07 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.7.3
+  type: :runtime
+  version_requirements: *id002
+description: Ruby wrapper for the Indeed Job search API
+email: john.crepezzi@patch.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/indeed_api/indeed_error.rb
+- lib/indeed_api/job.rb
+- lib/indeed_api/version.rb
+- lib/indeed_api.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://seejohnrun.github.com/indeed/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: indeed_api
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for the Indeed Job API
+test_files: 
+- spec/spec_helper.rb