Recsphere Public API
The Recsphere Public API lets you integrate vacancy listings and candidate applications directly into your website.
Base URL: https://api.recsphere.co.uk
All endpoints are under /v1/.
What you can do
- List vacancies — fetch a filtered, paginated list of your active vacancies to display on your careers page
- Accept applications — submit candidate applications (with CV upload) directly into Recsphere
Getting your API key
- Log into the Recsphere portal
- Navigate to Settings → API Access
- Your API key is displayed — click Show token to reveal it
- Use Regenerate if you need to rotate the key (your old key is invalidated immediately)
Keep your API key secret
Do not commit it to source control or expose it in client-side JavaScript. Always call the Recsphere API from your server or a serverless function.
Next steps
- Set up authentication — add your API key to requests
- Fetch vacancies — query and filter your vacancy listings
- Submit applications — accept candidate applications on your site