Get Job Applications
This web service allows you to retrieve all Application IDs of candidates who have applied to all jobs for a particular account on Yahoo! HotJobs. The Authentication API determines the account.
This web service will also return the number of candidates that you can expect as a result of your query, if your query is a success.
URI
http://hj.yahooapis.com/v1/JobApplications;type=;from=;till=;start=;count=
Note:
- 'type' = A (Returns all applications for the job) or F (Returns only Fresh applications which have not been viewed through API yet). Default value is F.
- Use 'from' and 'till' to specify the date range for which the applications are required. Default date range is last 30 days. If value is older than 90 days, default value is considered
- 'from' and 'till' are Dates in Unix TimeStamp format (UTC)
- 'till' defaults to current date-time. Cannot be greater than current timestamp
- 'start' and 'count' should be integers.
- ‘start ‘ can have any value greater than 0, default value being 1.
- ‘count’ can have any value starting from 1 and maximum of 250, default value being 100. So if the value specified is more than 250, the number of results returned will be 100.
- In all case of invalid input parameters, the application will switch to its corresponding default value
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, which is the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC.
- X-Yahoo-HJAuth-Signature
The signature is MD5 hash of the XML request, request timestamp, token and license key in that order and is encoded in Hexadecimal format
Success Response XML for Get Job Application request
In above sample response "http://hj.yahooapis.com/v1/JobApplication/abc123" is the URL (without quotes) to be used in View Job Application API described below. The above URIs needs to be used to call the View Job Application API.
'total'specifies the maximum number of applications that are available for the specific criteria.
- ‘JobID’: The ID of the job for which this candidate applied.
- 'id' is application ID to be used to call the View Job Application API.
- ‘HJInternalJobId’: Internal Job identifier used by HotJobs.