jobdata

Removal of clearance_required field from job result structure

jobdataapi.com v4.2 / API version 1.7

0 min read · Aug. 21, 2024

We removed the field clearance_required from the job result structure. This affects all job results on the /api/jobs/ endpoint.

The main reason for this is that this was kind of a legacy part of the initial database structure and seemed to be rarely used/needed by anyone. Adding to this, the info stored in this field (a simple boolean) can be quite easily derived from the field description_string (+ job title in some cases) with a few search keywords, to determine if a job ad lists a security clearance (or the ability to obtain one) as a requirement for a job. A filter parameter for this didn't exist before, it was only part of the result set.

In case you were utilizing this info before you might want to check out this tutorial as a starting point for doing it in your own backend: How to Determine if a Job Post Requires Security Clearance). It was basically our approach, nothing fancy.

This change was part of a recent database/backend refactoring and migration effort to keep things as lean and simple as possible.

Related Docs

Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
Query behavior changes for application_url, title, and location filters
Introducing Vector Embeddings and Vector Search in the jobdata API
Added source/ATS and company filtering + source ID fields
Maximum value for "page_size" parameter increased to 5000
Added llms.txt and llms-full.txt for AI-friendly implementation guidance
Added Role Taxonomy Tags Endpoint + Job Role Filters
Added salary estimates + global currency conversion API endpoint
Full job data downloads now available!
Added salary estimates and converted values + location_string to download CSVs
Improved API query validation
Added application URL query filter + (multi) country code parameter enhancements
jobdataapi.com now has Changelog section 🎉
Optimized Vector Embeddings & Search
Added company website/domain filter to jobs endpoint
Change of length for job title and location fields
Added new Job States (geo) endpoint, query filters, and more
Enhanced multi-value parameters for Job and Company queries
GeoNames upgrade, new population field and filters, expired field now in job results
Job filtering by vector embedding now available + added Apprenticeship job type