I want to have a module developed for the following task (6.x).

I would like to create a section for jobs on my site using the Jobs API provided by Jobamatic.
Here is some information to start with:
http://blog.jobamatic.com/2009/11/developer-api-now-available.html
http://blog.jobamatic.com/2009/12/current-international-publisher-offeri...

I would like to have the listings pulled out of these api and be displayed in the site realtime. The search box should include basic mode which searches for the job based on a keyword and location. Advanced mode should allowed further filtering.

See attachment for API details below.

USA Jobs API

Job Search XML API
Take full control of how jobs are displayed on your site.
Overview

This API can be used to build custom job search sites, job portals and career-related internet applications, but please note that it requires advanced technical skills to implement. No pre-approval is needed to use this API, but Simply Hired does not offer technical support to publishers using the API.

The Job Search XML API offers developers underlying job search results, but does not offer functionality for the dynamic filtering or categorization of jobs. Publishers that choose to use Job-a-matic job posting features will receive relevant Job-a-matic posted jobs at the top of the returned XML API search requests.
Requirements

Use of this API is governed by the Terms of Service, which, among other things, requires that publishers show the following Simply Hired attribution on every page that incorporates data returned from the API:
<div style="text-align: right;"><a STYLE="text-decoration:none" href="http://www.simplyhired.com/"><span style="color: rgb(0, 0, 0);">Jobs</span></a> by <a STYLE="text-decoration:none" href="http://www.simplyhired.com/"><span style="color: rgb(0, 159, 223); font-weight: bold;">Simply</span><span style="color: rgb(163, 204, 64); font-weight: bold;">Hired</span></a></div>

In order to accurately track job clicks, publishers are required to insert the "onMouseDown" attribute to all job link anchor tags and add the corresponding JavaScript source to all pages that display data from the API.
< href="..." onMouseDown="xml_sclk(this);">View Job</a>
<script type="text/javascript" src="http://api.simplyhired.com/c/jobs-api/js/xml-v2.js"></script>
Getting Started

Use the following URL format to request XML results:
http://api.simplyhired.com/a/jobs-api/xml-v2/q-Embedded+System?pshid=19984&ssty=2&cflg=r&jbd=embedded.jobamatic.com&clip=69.181.5.128

This will generate an XML document which will validate against the following DTD:
http://api.simplyhired.com/c/jobs-api/html/sr2.dtd
Job Search Parameters
Parameter Description
q

Query. A URL-encoded collection of terms indicating the search criteria.

    * AND - Match all of the terms connected by AND. The default connector for search terms (case sensitive)
    * OR - Match at least on of the terms connected by OR (case sensitive)
    * NOT - Exclude matches on these terms (case sensitive)
    * ( ) - Group order of operations

The XML API supports basic Boolean searches as follows. The XML API also supports these job-related search requests using the q- parameter:

    * All the words: Engineering AND Manager
    * Exact phrase: "Engineering Manager"
    * At least one of the words: Engineering OR Manager
    * Without words: Engineering NOT Manager
    * Job title: title:(Engineering Manager)
    * Company name: company:(Apple)
    * Occupation onet: onet:(13-205*)
      (Based on O*net, the U.S. Government's Occupation Classification System. Learn more.)

For additional examples, see the advanced search parameters on our Advanced Search Page.
l Location. A URL-encoded collection of terms indicating the geographic filter for the results. Location can be a zipcode, state, or city-state combination. Currently, there is no support for multiple location search.
mi Miles (Optional). A parameter indicating the number of miles from the location specified by the "l" parameter above. Miles value should be a number from "1" to "100". Miles represents the radius from the zip code, if specified in Location, or an approximate geographical "city center" if only city and state are present. If Miles is not specified, search will default to a radius of 25 miles. For jobs only within a specific city use "mi-exact".
sb

Sort By (Optional). A parameter indicating the sort order of organic jobs (sponsored jobs have a fixed sort order).

Valid values include:

    * rd = relevance descending (default)
    * ra = relevance ascending
    * dd = last seen date descending
    * da = last seen date ascending
    * td = title descending
    * ta = title ascending
    * cd = company descending
    * ca = company ascending
    * ld = location descending
    * la = location ascending

ws Window Size (Optional). An integer representing the number of results returned. When available, the XML Results API will return 10 jobs by default. The API is limited to a maximum of 100 results per request.
pn Page Number. An integer representing the page number of the results returned.
Job Search GET Parameters
Parameter Description Required Value
pshid Publisher ID. A required value, which identifies your publisher account. pshid=19984
jbd Job-a-matic domain. A required value, which is used to identify publishers that choose to continue accepting Job-a-matic job postings. jbd=embedded.jobamatic.com
ssty Search Style. A required search configuration value. ssty=2
cflg Configuration Flag. A required search configuration value. cflg=r
clip Client IP. A required value, which contains the IP address of the visitor. clip=[visitor's IP]
Key Response Tags
Parameter Description
Request Information
rq Request - Container tag for request information
t Request title
dt Date and time of request
si Start index request
rpd Number of returned results
tr Total results
tv Total viewable records (number of records available via the XML API)
em Not used
h Not used
Search Results
rs Results Set - Container tag for job results
r Result - Container tag for individual job result
jt Job Title
cn Company Name
src Source - This is the source of the job; url attribute provides the URL to the job posting
ty

Job type - This described the type of job: paid, sponsored or organic.

    * Paid jobs were posted directly to the site for a flat fee.
    * Sponsored jobs generate revenue on a CPC basis.
    * Organic job generate revenue on an affiliate basis.

loc

Location city and state. The following attributes provide supplemental information.

    * cty = city
    * st = state abbreviation
    * postal = postcode
    * county = county, when available
    * region = region, when available
    * country = country

ls The date that the job was last seen. (Verified to be an active listing)
dp The date that the job was first posted. (First date included in the Simply Hired database.)
e Excerpt of job description.

INDIA Jobs API
Job Search XML API
Take full control of how jobs are displayed on your site.
Overview

Simply Hired's Job Search XML API is used by publishers that need more control around how jobs are displayed on their site.

This API can be used to build custom job search sites, job portals and career-related internet applications, but please note that it requires advanced technical skills to implement. No pre-approval is needed to use this API, but Simply Hired does not offer technical support to publishers using the API.

The Job Search XML API offers developers underlying job search results from the Simply Hired search index, but does not offer functionality for filtering, categorization, posting or monetization of jobs. If you are currently accepting international job postings on your Job-a-matic site, the international Job Search XML API will not display your posted jobs.
Requirements

Use of this API is governed by the Terms of Service, which, among other things, requires that publishers (1) do not store the data returned and (2) show the following Simply Hired attribution on every page that incorporates data returned from the API:
<div style="text-align: right;"><a STYLE="text-decoration:none" href="http://www.simplyhired.co.in/"><span style="color: rgb(0, 0, 0);">Jobs</span></a> by <a STYLE="text-decoration:none" href="http://www.simplyhired.co.in/"><span style="color: rgb(0, 159, 223); font-weight: bold;">Simply</span><span style="color: rgb(163, 204, 64); font-weight: bold;">Hired</span></a></div>

In order to accurately track job clicks, publishers are required to insert the "onMouseDown" attribute to all job link anchor tags and add the corresponding JavaScript source to all pages that display data from the API.
< href="..." onMouseDown="xml_sclk(this);">View Job</a>
<script type="text/javascript" src="http://api.simplyhired.co.in/c/jobs-api/js/xml-v2.js"></script>
Getting Started

Use the following URL format to request XML results:
http://api.simplyhired.co.in/a/jobs-api/xml-v2/q-Embedded+System/pn-1?pshid=19984&ssty=3&cflg=r&clip=69.181.5.128

This will generate an XML document which will validate against the following DTD:
http://api.simplyhired.co.in/c/jobs-api/html/sr2.dtd
Job Search Parameters
Parameter Description
q

Query. A URL-encoded collection of terms indicating the search criteria.

    * AND - Match all of the terms connected by AND. The default connector for search terms (case sensitive)
    * OR - Match at least on of the terms connected by OR (case sensitive)
    * NOT - Exclude matches on these terms (case sensitive)
    * ( ) - Group order of operations

The XML API supports basic Boolean searches as follows. The XML API also supports these job-related search requests using the q- parameter:

    * All the words: Engineering AND Manager
    * Exact phrase: "Engineering Manager"
    * At least one of the words: Engineering OR Manager
    * Without words: Engineering NOT Manager
    * Job title: title:(Engineering Manager)
    * Company name: company:(Apple)

For additional examples, see the advanced search parameters on our Advanced Search Page.
l Location. A URL-encoded collection of terms indicating the geographic filter for the results. Location can be a postal code, province/state, or city-province combination. Currently, there is no support for multiple location search.
mi Miles (Optional). A parameter indicating the number of miles from the location specified by the "l" parameter above. Miles value should be a number from "1" to "100". Miles represents the radius from the zip code, if specified in Location, or an approximate geographical "city center" if only city and state are present. If Miles is not specified, search will default to a radius of 25 miles. For jobs only within a specific city use "mi-exact". (1 km = 0.62 miles; 1 mile = 1.6 km)
sb

Sort By (Optional). A parameter indicating the sort order of organic jobs (sponsored jobs have a fixed sort order).

Valid values include:

    * rd = relevance descending (default)
    * ra = relevance ascending
    * dd = last seen date descending
    * da = last seen date ascending
    * td = title descending
    * ta = title ascending
    * cd = company descending
    * ca = company ascending
    * ld = location descending
    * la = location ascending

ws Window Size (Optional). An integer representing the number of results returned. When available, the XML Results API will return 10 jobs by default. The API is limited to a maximum of 100 results per request.
pn Page Number. An integer representing the page number of the results returned.
Job Search GET Parameters
Parameter Description Required Value
pshid Publisher ID. A required value, which identifies your publisher account. pshid=19984
ssty Search Style. A required search configuration value. ssty=3
cflg Configuration Flag. A required search configuration value. cflg=r
clip Client IP. A required value, which contains the IP address of the visitor. clip=[visitor's IP]
Key Response Tags
Parameter Description
Request Information
rq Request - Container tag for request information
t Request title
dt Date and time of request
si Start index request
rpd Number of returned results
tr Total results
tv Total viewable records (number of records available via the XML API)
em Not used
h Not used
Search Results
rs Results Set - Container tag for job results
r Result - Container tag for individual job result
jt Job Title
cn Company Name
src Source - This is the source of the job; url attribute provides the URL to the job posting
ty Job type - This describes the type of job listing.
loc

Complete location string. The following attributes provide supplemental information.

    * cty = city, district or province
    * st = province, region or state abbreviation
    * postal = postcode
    * county = county, when available
    * region = region, when available
    * country = country

ls The date that the job was last seen. (Verified to be an active listing)
dp The date that the job was first posted. (First date included in the Simply Hired database.)
e Excerpt of job description.

Thanks for your time to review this. I would like to sponsor the module development and I would like for this module to be contributed back to the d.o

-Victor

Comments

robphillips’s picture

Hey vkr11, sent over a message from your contact form.

BeaPower’s picture

Is this complete? Id like this too

aamin’s picture

I would like this too..

wallbay1’s picture

subscribing

enzipher’s picture

Does anyone have an update on this? There is a slight possibility that I will need to integrate the Jobamatic service, and in that case I could help out with this.

Thanks

--
hook_world() is broken.

vkr11’s picture

Not much yet, still looking forward to have this.. Any help would be great.

Thanks

r0nn1ef’s picture

I have developed a working module to integrate with the SimplyHired API for D7. I've got some "clean up" work to do on the code before I create a project on drupal.org, but you can email me and I'll send you a zip file with the module.

______________________________________
Ronald Ferguson
Web Developer and Consultant
www.ronferguson.net


Don't tell people how to do things, tell them what to do and let them surprise you with their results.

BeaPower’s picture

Hi currently I am testing out your sandbox and will tell you how it goes, thanks.

BeaPower’s picture

The only problem is that the link - content/jobamatic/view does not work and I get a Page not found on my site.

-- nevermind the new link directed me to /content/simply_hired_jobamatic/view
-- How do I keep the search criteria box open always? And I would like to add a small description to the page, how?
-- It would be nice if users could post jobs to board with a fee... how is that possible?

Thanks for this great module!!

r0nn1ef’s picture

the module currently does not support the advanced search field set to be open by default. I might be able to add a setting for that in the future.

As for being able to post jobs to the board, you'll have to use a block or some other method to put a link to your jobamatic URL. The API doesn't support posting jobs. I'm using the context module to place a HTML block in a region i added to my theme file called "above_content".

Glad you like the module. Let me know if there are any issues. I'm trying to get this ready to submit for a full project and I need all the help I can get.

______________________________________
Ronald Ferguson
Web Developer and Consultant
www.ronferguson.net


Don't tell people how to do things, tell them what to do and let them surprise you with their results.