HiringThing API
For developers, HiringThing offers an API that allows access to all your account information, essentially connecting you directly to the HiringThing Recruiting Engine™. Using our API requires knowledge of programming languages and software – if that’s not you, recruit your local coder to lend a hand.
This is our read-only API. If you’re interested in using our write API, please drop us a note.
The HiringThing API gives you access to the following resource entities:
The HiringThing API is designed as REST resources. For Ruby developers, the easiest way to get started is by using the hiringthing_api gem.
API Access
The API is authenticated using HTTP Basic Auth over SSL. You will need an API key (http username) and a password. The API key and password can be obtained by enabling the API in the Account Details section of the HiringThing online interface.
https://<your-subdomain>.hiringthing.com/remote/<entity endpoint>
Interacting with Entities
Here are some examples of common operations using the API:
| Jobs | get |
|---|---|
jobs |
List of all jobs. |
jobs/active |
List jobs shown online. |
jobs/hidden |
List hidden jobs. |
jobs/archived |
List inactive jobs. |
jobs/<job_id> |
Fetch a particular job. |
| Applications | get |
applications |
List of applications. |
applications/unrated |
List of new unrated applications. |
applications/rated |
List of rated applications. |
applications/archived |
List of archived applications. |
applications/<app_id> |
Fetch a particular application. |
| Applications for a Particular Job | get |
jobs/<job_id>/applications |
List of applications. |
jobs/<job_id>/applications/unrated |
List of new unrated applications. |
jobs/<job_id>/applications/rated |
List of rated applications. |
jobs/<job_id>/applications/archived |
List of archived applications. |
An example of a complete valid API call:
https://gadgetco.hiringthing.com/remote/jobs/1234/applications/unrated.json
More information here:
