Vacancies — HireLens Docs

Documentation

Title Section Slug Order Published

# Vacancies

The Vacancies page is the core exploration interface — where you search, filter, and analyze every hiring signal in the platform.

---

## AI-Powered Search

The search bar uses **vector embeddings** to understand your intent, not just match keywords.

### How It Works
When you type a query, HireLens:
1. Generates a vector embedding of your search text
2. Compares it against embeddings of all vacancy descriptions
3. Returns the most semantically similar results
4. Applies any active filters on top

This means searching for "machine learning infrastructure" will find positions titled "ML Platform Engineer", "MLOps Lead", or "AI Infrastructure Developer" — even without exact keyword matches.

### Search Tips
- **Be natural** — Write queries as you would describe what you are looking for
- **Add context** — "senior rust developer for DeFi protocol" is more precise than "rust developer"
- **Salary hints** — "$150k+ remote backend" incorporates salary expectations

---

## Filter System

The left sidebar provides multi-dimensional filtering:

| Filter | Options | Use Case |
|--------|---------|----------|
| **Role** | 20+ standardized roles | Find specific positions |
| **Seniority** | Junior to C-Level | Match your experience level |
| **Domain** | DeFi, NFT, Gaming, Infra, etc. | Focus on your industry |
| **Salary** | USD range slider | Find positions in your range |
| **Location** | Remote / Office / Hybrid | Match your preference |
| **Risk** | Low / Medium / High | Filter out suspicious listings |
| **Score** | 0-10 range | Only show quality signals |
| **Source** | Specific channels/scrapers | Track particular sources |
| **Date** | 7 / 30 / 90 / 180 / 365 days | Focus on recent activity |

Filters combine with AND logic — each additional filter narrows the result set.

---

## Vacancy Cards

Each card displays:
- **Title** and **company** (with logo when available)
- **AI Score** — color-coded badge (green 7+, yellow 4+, red below 4)
- **Salary range** in normalized USD
- **Tags** — seniority, domains, location type, employment type
- **Risk label** — if flagged by AI analysis
- **Source** — where the signal was collected from
- **Time** — when it was first seen

### Score Breakdown
The AI score (0-10) factors in:
- Completeness of the listing (salary, requirements, company info)
- Clarity and specificity of role description
- Presence of red flags (vague requirements, unrealistic promises)
- Company profile quality

---

## Detail View

Click any vacancy to see the full analysis:
- Complete AI-processed description
- Extracted **skills and technologies**
- **Company profile** link with enrichment data
- **Original source** reference
- All extracted metadata in structured form

Documentation

New Article