Search Results
This web service allows you to programmatically obtain the resumé search results given a valid search id. The structure of the search results are described below; however these depend on the information that is provided by the job seeker to Yahoo! HotJobs, since the job seeker is not required to fill in all of these fields.
You can choose the candidates from the results set, you want to view the resumes of. For each resumé you want to view, you need to call the Resumé View API.
URI
http://hj.yahooapis.com/v1/ResumeFilter/<SearchId>/Resumes;start=x;count=y
Note:
- The user needs to provide the search ID for getting the results.
- x and y should be the integers which correspond to values of start and count parameter, respectively.
- ‘start‘ can have any value between 1 and 990, default value being 1.
- ‘count’ can have any value between 10 and 100, default value being 50. If the value given is more than 100, the number of results returned will be 100. Similarly, if the value given is less than 10, the number of results returned will be 10.
- Maximum number of results returned per query will be 1000.
HTTP Method
GET
HTTP Custom Headers
- X-Yahoo-HJAuth-Token
This is session token returned by Authentication web service.
- X-Yahoo-HJAuth-Timestamp
This should be the request timestamp in Unix Timestamp format (the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC).
- X-Yahoo-HJAuth-Signature
The signature is MD5 hash (in Hexadecimal format) of the concatenation of the request timestamp, search ID, token and the license key. For example,
Request Timestamp = 1234567890
Search ID = 55555
Token = ABC123xyz--
License Key = b0ab1bfdd898b7588142e820a2af1a07
Hash string (Request Timestamp + Search ID + Token + License Key) =
123456789055555ABC123xyz--b0ab1bfdd898b7588142e820a2af1a07
Signature (MD5 hash of the hash string) = 56e4ee0296ca0a3b29fb1db223b66a90
Parameters
| Field | Description |
|---|---|
| ID | Primary key for job seeker’s HotJobs resumé. This ID can be used for retrieving full resumé text. This token should be effectively permanent. In other words, the user of the API should be able to store it after a search, and later (in another session) retrieve the resumé. The retrieval could be seconds, days or months after the search. |
| CandidateID | Unique identifier for the candidate - this is unique across multiple searches. |
| CandidateResumeID | Unique identifier for the candidate's resumé - this is unique across multiple searches. |
| FirstName | Job seeker’s first name. |
| LastName | Job seeker’s last name. |
| City | Job seeker’s city. |
| State | Job seeker’s state. |
| Province | Job seeker’s province. (Canada only) |
| Country | Job seeker’s country.
Available only if job seeker lives outside of US. |
| HireType | Position Type. |
| DesiredSalary | Minimum Salary desired by the job seeker. |
| Title | Most recent job title of the candidate. |
| Employer | Most recent employer that candidate has worked with. |
| Experience | Job seeker’s experience level. |
| WorkAuthCountry | Countries (up to 3) where the candidate is authorized to work in. |
| LastUpdated | The date on which the job seeker’s resumé / profile was last revised. |
| Degree | Candidate’s Education Level. |
| Duration | Whether the job seeker intends to work full time or part time. |
| TravelPreference | Travel preference of the job seeker in percentage terms. |
| Language & Proficiency | Languages (with proficiency) spoken by the user (up to 3). |
| Industry | Job category of the candidate. |