FilterSpec is the query language for filtering employees. It provides a simple, declarative way to build complex searches without writing raw Elasticsearch queries.
Structure
{
textAny?: [], // Match ANY of these text terms (OR)
textAll?: [], // Match ALL of these text terms (AND)
range?: [], // Numeric range filters
termsAny?: [], // Exact match ANY of these values (OR)
termsAll?: [], // Exact match ALL of these values (AND)
exists?: [], // Field must exist
notExists?: [] // Field must NOT exist
}
Filter Types
textAny / textAll
For fuzzy/partial matching on free-text fields like job titles, headlines, descriptions.
// Match people with "engineer" OR "developer" in job_title
textAny: [{ field: "job_title", terms: ["engineer", "developer"] }];
// Match people with BOTH "senior" AND "engineer" in job_title
textAll: [{ field: "job_title", terms: ["senior", "engineer"] }];
job_title, headline, description, skills, experience.title, experience.description
termsAny / termsAll
For exact matching on discrete/enum fields. Required for all enum-backed fields.
// Match people in Engineering OR Sales departments
termsAny: [{ field: "department", values: ["Engineering and Technical", "Sales"] }];
// Match by company ID
termsAny: [{ field: "experience.company_id", values: [12345] }];
department, management_level, location_regions, experience.company_id, experience.company_industry
range
For numeric comparisons with gte (≥) and lte (≤).
// 50-500 employees at current company
range: [{ field: "experience.company_size_employees_count", gte: 50, lte: 500 }];
// At least 100 connections (capped at 500)
range: [{ field: "connections_count", gte: 100 }];
connections_count is capped at 500 in the data source.
exists / notExists
For checking field presence.
// Must have a profile picture
exists: [{ field: "picture_url" }];
// Currently employed (no end date on current role)
notExists: [{ field: "experience.date_to" }];
Enum Values Reference
These fields require exact values from the lists below. Use termsAny or termsAll.
department
C-Suite, Finance & Accounting, Human Resources, Legal, Administrative,
Engineering and Technical, Sales, Customer Service, Product, Project Management,
Marketing, Design, Operations, Research, Trades, Consulting, Medical,
Real Estate, Education, Other
management_level
Specialist, Manager, Senior, Director, Owner, C-Level, Intern, Head,
President/Vice President, Founder, Partner
location_regions
Hierarchical regions (use the most specific that applies):
| Level | Examples |
|---|
| Macro | AMER, EMEA, APAC |
| Continent | Northern America, Europe, Asia, Africa, Oceania |
| Sub-region | Northern Europe, Western Europe, South-Eastern Asia, Southern Asia |
| Country | United States, United Kingdom, Germany, India, Australia |
| State/Province | California, United States, Texas, United States, Ontario, Canada |
company_size_range
1 employee, 2-10 employees, 11-50 employees, 51-200 employees,
201-500 employees, 501-1,000 employees, 1,001-5,000 employees,
5,001-10,000 employees, 10,001+ employees
company_industry
Common values (200+ total):
Computer Software, Information Technology and Services, Financial Services,
Internet, Marketing and Advertising, Hospital & Health Care, Banking,
Management Consulting, Biotechnology, Telecommunications, E-Learning,
Real Estate, Insurance, Retail, Automotive, Pharmaceuticals, ...
Common Fields
Profile Fields (top-level)
| Field | Type | Description |
|---|
job_title | text | Current job title |
headline | text | LinkedIn headline |
description | text | About/summary section |
skills | text | Skills array |
department | enum | Function area |
management_level | enum | Seniority level |
location_regions | enum | Geographic location |
connections_count | range | LinkedIn connections (max 500) |
follower_count | range | LinkedIn followers |
Experience Fields (nested under experience.)
| Field | Type | Description |
|---|
experience.title | text | Job title at company |
experience.description | text | Role description |
experience.company_id | terms | CoreSignal company ID |
experience.company_name | text | Company name |
experience.company_industry | enum | Company’s industry |
experience.company_size_employees_count | range | Employee count |
experience.company_size_range | enum | Size bucket |
experience.department | enum | Department in that role |
experience.management_level | enum | Level in that role |
experience.date_from | exists | Role start date |
experience.date_to | exists | Role end date (null if current) |
Examples
VP+ in Engineering at mid-size companies in California
{
termsAny: [
{ field: "department", values: ["Engineering and Technical"] },
{ field: "management_level", values: ["President/Vice President", "C-Level", "Director"] },
{ field: "location_regions", values: ["California, United States"] }
],
range: [
{ field: "experience.company_size_employees_count", gte: 50, lte: 1000 }
]
}
Sales leaders at SaaS companies
{
textAny: [{ field: "experience.company_industry", terms: ["SaaS", "Software"] }],
termsAny: [
{ field: "department", values: ["Sales"] },
{ field: "management_level", values: ["Director", "Head", "President/Vice President"] }
]
}
Currently employed (no end date)
{
notExists: [{ field: "experience.date_to" }];
}
People with specific skills
{
textAll: [{ field: "skills", terms: ["Python", "Machine Learning"] }];
}
