Node Reference — HireLens Docs

Documentation

Title Section Slug Order Published

# Studio Node Reference

Complete reference for every node type available in Analytics Studio.

---

## Source Nodes (Green)

Source nodes define where your data comes from. Every pipeline must start with at least one source.

### Vacancies
Loads all vacancy signals from the database.

**Available fields for downstream nodes:**
- `title` — Vacancy title
- `role` — Standardized role (Backend, Frontend, etc.)
- `seniority` — Experience level (Junior, Middle, Senior, Lead, C-Level)
- `salary_min`, `salary_max` — Normalized salary in USD
- `company_name` — Associated company
- `domains` — Industry domains (array)
- `location_type` — Remote / Office / Hybrid
- `employment_type` — Full-time / Part-time / Contract
- `score` — AI quality score (0-10)
- `risk_label` — Risk assessment
- `created_at` — When the signal was first collected
- `source_channel` — Origin source

### Companies
Loads all enriched company profiles.

**Available fields:**
- `name` — Company name
- `website` — Corporate URL
- `industry` — Industry classification
- `company_size` — Startup / Small / Medium / Large / Enterprise
- `headquarters` — HQ location
- `vacancies_count` — Number of active positions

---

## Filter Nodes (Blue)

Filter nodes narrow your dataset. Each filter removes rows that do not match the criteria.

### By Role
Select one or more standardized roles to keep.
- **Config:** Multi-select dropdown with all available roles
- **Example:** Keep only Backend and Frontend positions

### By Seniority
Filter by experience level.
- **Config:** Multi-select dropdown (Junior, Middle, Senior, Lead, C-Level)

### By Domain
Filter by industry vertical.
- **Config:** Multi-select dropdown (DeFi, NFT, Gaming, Infrastructure, etc.)

### By Salary
Set minimum and/or maximum salary range.
- **Config:** Min and Max numeric inputs (USD)

### By Date
Keep only recent signals.
- **Config:** Dropdown — Last 7 / 30 / 90 / 180 / 365 days

### By Score
Filter by AI quality score.
- **Config:** Min and Max score (0-10)

### By Location
Filter by location type.
- **Config:** Dropdown (Remote / Office / Hybrid)

---

## Aggregation Nodes (Purple)

These nodes transform your data — grouping, computing metrics, sorting, and limiting.

### Group By
Groups rows by a selected field. Required before Aggregate.
- **Config:** Field selector dropdown
- **Common fields:** role, seniority, company_name, location_type, employment_type, domain
- **Date truncation:** When grouping by created_at, choose: day, week, month, quarter

### Aggregate
Computes metrics on grouped data. Connect after Group By.
- **Config:**
  - **Function** — COUNT, AVG, SUM, MIN, MAX
  - **Field** — Which field to apply the function to
  - **Alias** — Column name for the result

**Tips:**
- Use COUNT on `id` for counting rows per group
- Use AVG on `salary_min` for average salary analysis
- The alias becomes a column name used in Sort and Chart nodes

### Sort
Orders results by a column.
- **Config:**
  - **Field** — Dropdown (auto-populated from upstream Group By + Aggregate columns)
  - **Direction** — ASC (ascending) or DESC (descending)

The dropdown is **smart** — it only shows columns that actually exist at this point in the pipeline.

### Limit
Caps the number of output rows.
- **Config:** Number input (default: 10)

---

## Output Nodes (Yellow)

### Chart
Renders results as a visual chart.

| Type | Best For |
|------|----------|
| **Bar** | Comparing values across categories |
| **Line** | Showing trends over time |
| **Doughnut** | Showing proportions of a whole |
| **Polar Area** | Comparing magnitudes in a radial layout |
| **Radar** | Multi-dimensional comparison |

**Configuration:**
- **Type** — Select chart type
- **Label Column** — What goes on X axis / segments
- **Value Columns** — What gets plotted

For Doughnut and Polar Area charts, select one value column — each row becomes a segment. For Bar and Line charts, you can select multiple value columns.

### Table
Displays results as a sortable, scrollable data table.

### Export CSV
Downloads results as a CSV file.

Documentation

New Article