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. Poll until each task reaches
completed. While work is still active, the status endpoint can return in_progress or retrying. If you poll an unknown ID, the endpoint returns not_found for that item.Quick links
Quickstart
Make your first API call and match a candidate to a job.
Authentication
Set up API key authentication for your requests.
API Reference
Browse all endpoints with interactive examples.
Supported Languages
View all languages available for skill translation.