📘

Prerequisites

1. ✨ Create a Workspace Set up your environment in the HrFlow.ai portal.
2. 🔑 Get your API Key Retrieve your API_KEY from the settings.
3. 🧠 Activate Job Embedding API Ensure the embedding service is enabled for your plan.

The Embedding API generates SOTA, HR-native, and cross-lingual vectors for Jobs to power similarity search, retrieval, clustering, and HR-grade ML. Unlike generic LLM vectors, these encoders are pretrained on 1.2B hiring decisions to capture signals beyond keywords to identify "Intent-Similar" jobs a candidate is likely to click and apply to.

This endpoint allows you to vectorize jobs by providing either raw data objects or references to profiles already indexed in your sources. Results are deterministic: the same inputs will consistently return the same vectors.

1. How to get a Job Object

This endpoint requires structured data as input. You can obtain a valid HrFlow.ai Job Object through two primary methods:

• Manual Construction: Build the object programmatically by following our Job Object Specification 📖 The Job Object .
• Automated Parsing: Convert a raw job description or file into a structured Job Object using our Parsing API (e.g. Job Parsing). This is an ease-of-use feature that ensures your job data is normalized and "HR-ready" for vectorization.

2. Available Algorithms

Choose the right algorithm key based on your use case, data type, and precision needs.

3. Request headers