Added Role Taxonomy Tags Endpoint + Job Role Filters

Table of contents

We’ve added a new Tags API endpoint to make role-based job discovery much easier and more precise.

With this release, you can now browse and query our role taxonomy directly via /api/tags/ and use those tag IDs to filter job results on /api/jobs/.

What’s new

• New /api/tags/ endpoint with list + detail access.
• Tag hierarchy output includes parent role context, so you can map broad role groups to more specific role labels.
• New role-based job filters on /api/jobs/: tag_id, role1_id, role2_id, and role3_id.
• Optional tags=true parameter on /api/jobs/ to return nested role tags directly in job results.

The Tags endpoint, role-based job filters, and nested tags=true job output are available with an active API access pro+ (or higher) subscription.

Benefits and Implications

This update makes it much easier to build role-first product experiences. Instead of relying only on raw title text, you can now query jobs through structured role tags and hierarchy levels, which leads to cleaner search, better recommendations, and more consistent grouping of similar positions across different companies and naming styles.

It also improves downstream analytics and segmentation quality. With standardized role levels available directly in API workflows, teams can compare trends by broad role family (ROLE1), role category (ROLE2), or specific specialization (ROLE3), making reporting and market insights more reliable and actionable.

See the Tags API Endpoint Documentation and Jobs API Endpoint Documentation for full usage examples.

Related Docs