Changelog
Become a partner
Start typing to search…
Back to All
Added

Hiring API: Job ad site and workspace type added

about 11 hours ago

The Hiring API enables developers to programmatically retrieve job ads from Bob and display them on external career pages. This update introduces new fields in the job ad payload that improve data accuracy and support more advanced filtering.

What's new

  • Accurate job ad location: The Hiring API now exposes the correct job ad location through a new jobAdSite field. Previously, the API only returned the site associated with the job opening, which resulted in incorrect data for multi-location job ads. This fix ensures consistency with what candidates see on career pages.
  • Workspace type: A new workspaceType field is now also exposed, allowing filtering job ads by work arrangement: Remote, Hybrid, or On-site, improving data granularity and personalization.

These updates improve the accuracy and usability of job ad data across public-facing platforms and integrations.

Public API updates

  • New fields added to job ad responses:
    • /jobAd/jobAdSiteId: The ID of the site that is defined for the job ad itself.
    • /jobAd/jobAdSite: The name of the site defined on the job ad itself.
    • /jobAd/jobAdCountry: The country name of the site is defined on the job ad itself.
    • /jobAd/workspaceTypeId: The ID of the workspace type defined on the job ad (e.g., "Remote", "Hybrid", "On-site").
    • /jobAd/workspaceType: The name of the workspace type defined on the job ad (e.g., "Remote", "Hybrid", "On-site").
  • Filtering and querying support:
    • Both jobAdSite and workspaceType can now be used in filters when querying job ads.
  • Updated schema and documentation:
    • Open API documentation has been updated with new field definitions and filtering options.

Action Items for developers

🚧

These changes are non-breaking and additive. However, developers are encouraged to switch to the nre job ad-level properties for better accuracy when using multiple locations for ads.

If you use the Hiring API to power your external career site:

  • Update any integration logic to use jobAdSite and jobAdSiteId instead of site for accurate job ad location.
  • Leverage the workspaceType field to filter or display work arrangement types.
  • Review the updated API documentation for full schema details and filter usage.
  • Notify any third-party partners you work with who may be relying on job location data in your external career page.

For more details, see Hiring API.