Welcome to the Fribl API
The Fribl API provides programmatic access to AI-powered recruitment intelligence. Analyze CVs and job descriptions, match candidates to positions with configurable scoring, search a multilingual skills taxonomy, and source candidates from external databases.Core capabilities
CV Analysis
Extract structured data from CVs including personal information, work experience, education, and skills — via text input or file upload.
Job Analysis
Parse job descriptions to extract requirements, preferred qualifications, skills, and role information automatically.
Candidate Matching
Match analyzed CVs against jobs with configurable weights across experience, skills, and education dimensions. Receive ranked results with detailed scoring explanations.
Skills Search
Query the ESCO-based skills taxonomy with support for multiple languages and filtering by skill type.
Candidate Sourcing
Search and discover candidate profiles from external databases, then ingest selected profiles into your workspace.
Full CRUD
Create, read, update, and delete both CVs and jobs. List all resources with pagination support.
How it works
The typical Fribl workflow follows three steps:Analyze
Submit CVs and job descriptions for AI-powered analysis. The API processes them asynchronously and returns task IDs. You can submit multiple documents in a single request.
Poll for status
Check processing status using the status endpoints. Each task moves through
PENDING → PROCESSING → COMPLETED (or FAILED).