jobdata

Job filtering by vector embedding now available + added Apprenticeship job type

jobdataapi.com v4.18 / API version 1.20

1 min read · Aug. 20, 2025
Table of contents

In addition to the already existing vec_text filter parameter on the /api/jobs/ endpoint it is now possible to use the same endpoint including all its GET parameters to send a 768 dimensional array of floats as JSON payload via POST request to match for job listings.

This way you're not limited to the vec_text constrains as a GET parameter with only providing text of up to ~1K characters, but can now use your own embeddings or simply those from jobs you already fetched to find semantically similar listings.

With this we now also added a new max_dist GET parameter to be applied optionally to a vec_text or vec_embedding search, setting the max. cosine distance value for the vector similarity search part.

These features are now available on all subscriptions with an API access pro+ or higher plan. See our updated docs for more info.

New Apprenticeship job type added

We saw, for quite a while now, the need to add a job type Apprenticeship to better differentiate certain listings that fall into this category from those that are pure internship roles.

You'll find this popping up on the /api/jobtypes/ endpoint and in relevant job posts from now on (across all API access plans).

Related Docs

Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
Added company flag for recruiting/staffing firms + enhanced filtering options
Added salary estimates + global currency conversion API endpoint
Added salary estimates and converted values + location_string to download CSVs
Added company open/total job counts + filters
Added llms.txt and llms-full.txt for AI-friendly implementation guidance
Added Remote Work Mode Classification
Removal of clearance_required field from job result structure
Change of length for job title and location fields
Enhanced Company HQ Data + new Geographic Filters
Improved API query validation
Maximum value for "page_size" parameter increased to 5000
jobdataapi.com now has Changelog section 🎉
Added source/ATS and company filtering + source ID fields
Added company website/domain filter to jobs endpoint
Added API Access Lite Plan + Smarter Age-Window Defaults for Jobs API
Full job data downloads now available!
Added plain-text field for cleaned job description
Query behavior changes for application_url, title, and location filters
New location, ID fields and filters