Search Filters Guide
Comprehensive guide to all available filters for LinkedIn search APIs
LinkedIn Search Filters Guide
This guide provides detailed information about all available filters for LinkedIn search endpoints, including nested options and valid values.
People Search Filters
When searching for people using /linkedin/search/people, you can use the following filters:
Basic Filters
| Filter | Type | Description | Example |
|---|---|---|---|
keywords | string | General search keywords | "software engineer" |
firstName | string | Filter by first name | "John" |
lastName | string | Filter by last name | "Doe" |
Title & Company Filters
| Filter | Type | Description | Example |
|---|---|---|---|
title | string | Job title with OR syntax support | "Engineering Manager OR VP Engineering OR CTO" |
company | string | Company name | "Google" |
currentCompanyIds | string[] | Array of LinkedIn company IDs for current employers | ["1441", "2063"] |
pastCompanyIds | string[] | Array of LinkedIn company IDs for past employers | ["1441"] |
Education & Location Filters
| Filter | Type | Description | Example |
|---|---|---|---|
school | string | School/university name | "Stanford University" |
locationId | string | LinkedIn location ID | "103644278" |
geoUrn | string | Full LinkedIn geo URN | "urn:li:fsd_geo:103644278" |
Connection & Network Filters
| Filter | Type | Values | Description |
|---|---|---|---|
connectionDegree | string[] | "F", "S", "O" | F = 1st degree connections S = 2nd degree connections O = 3rd+ degree connections |
Example:
{
"connectionDegree": ["F", "S"] // Only 1st and 2nd degree connections
}Industry & Profile Filters
| Filter | Type | Description | Example |
|---|---|---|---|
industry | string[] | Array of LinkedIn industry codes | ["4", "6", "96"] |
profileLanguage | string[] | Profile language codes (ISO 639-1) | ["en", "es", "fr"] |
serviceCategories | string[] | Service categories for professionals | ["consulting", "training"] |
openToWork | boolean | Filter by "Open to Work" status | true |
Common LinkedIn Industry Codes
| Code | Industry |
|---|---|
"4" | Computer Software |
"6" | Information Technology & Services |
"96" | Internet |
"43" | Marketing & Advertising |
"104" | Financial Services |
Job Search Filters
When searching for jobs using /linkedin/search/jobs, you can use the following filters:
Basic Filters
| Filter | Type | Description | Example |
|---|---|---|---|
keywords | string | Search keywords | "software engineer" |
locationId | string | LinkedIn location ID | "103644278" |
geoUrn | string | Full LinkedIn geo URN | "urn:li:fsd_geo:103644278" |
companyIds | string[] | Array of LinkedIn company IDs | ["1441", "2063"] |
Job Type Filter
| Filter | Type | Values | Description |
|---|---|---|---|
jobType | string[] | "F", "P", "C", "T", "I", "V", "O" | F = Full-time P = Part-time C = Contract T = Temporary I = Internship V = Volunteer O = Other |
Example:
{
"jobType": ["F", "C"] // Full-time and Contract only
}Experience Level Filter
| Filter | Type | Values | Description |
|---|---|---|---|
experienceLevel | string[] | "1", "2", "3", "4", "5", "6" | 1 = Internship 2 = Entry level 3 = Associate 4 = Mid-Senior level 5 = Director 6 = Executive |
Example:
{
"experienceLevel": ["3", "4"] // Associate and Mid-Senior level
}Workplace Type Filter
| Filter | Type | Values | Description |
|---|---|---|---|
workplaceType | string[] | "1", "2", "3" | 1 = On-site 2 = Remote 3 = Hybrid |
Example:
{
"workplaceType": ["2", "3"] // Remote and Hybrid only
}Date Posted Filter
| Filter | Type | Values | Description |
|---|---|---|---|
datePosted | string | "past-24h", "past-week", "past-month", "any-time" | Filter by when the job was posted |
Example:
{
"datePosted": "past-week" // Jobs posted in the last 7 days
}Additional Job Filters
| Filter | Type | Description | Example |
|---|---|---|---|
salary | string | Salary filter (LinkedIn format) | "$100,000+" |
industry | string[] | Industry codes | ["4", "6"] |
jobFunctions | string[] | Job function codes | ["eng", "it"] |
titles | string[] | Job titles | ["Software Engineer", "Developer"] |
benefits | string[] | Job benefits | ["health-insurance", "401k"] |
commitments | string[] | Commitment types | ["full-time-commitment"] |
easyApply | boolean | Filter by Easy Apply jobs | true |
Company Search Filters
When searching for companies using /linkedin/search/companies, you can use the following filters:
Basic Filters
| Filter | Type | Description | Example |
|---|---|---|---|
keywords | string | Search keywords | "technology startup" |
locationId | string | LinkedIn location ID | "103644278" |
geoUrn | string | Full LinkedIn geo URN | "urn:li:fsd_geo:103644278" |
industry | string[] | Industry codes | ["4", "6", "96"] |
Company Size Filter
| Filter | Type | Values | Description |
|---|---|---|---|
companySize | string[] | "A" to "I" | A = 1-10 employees B = 11-50 employees C = 51-200 employees D = 201-500 employees E = 501-1,000 employees F = 1,001-5,000 employees G = 5,001-10,000 employees H = 10,001+ employees I = Self-employed |
Example:
{
"companySize": ["C", "D", "E"] // Companies with 51-1,000 employees
}Additional Company Filters
| Filter | Type | Description | Example |
|---|---|---|---|
companyType | string[] | Company type identifiers | ["PUBLIC_COMPANY", "PRIVATELY_HELD"] |
followedCompanies | boolean | Filter by companies you follow | true |
Group Search Filters
When searching for groups using /linkedin/search/groups, you can use the following filters:
Basic Filters
| Filter | Type | Description | Example |
|---|---|---|---|
keywords | string | Search keywords | "javascript developers" |
memberCount | string | "small", "medium", "large" | Filter by group size (not fully implemented by LinkedIn) |
Common Filter Patterns
Pagination
All search endpoints support pagination parameters:
{
"count": 25, // Number of results per page (1-100, default: 25)
"start": 0, // Starting index (default: 0)
"sortBy": "relevance" // Sort order (varies by endpoint)
}Combining Multiple Filters
You can combine multiple filters for precise targeting:
{
"keywords": "senior software engineer",
"filters": {
"title": "Engineering Manager OR VP Engineering OR Director",
"company": "Google",
"connectionDegree": ["F", "S"],
"locationId": "103644278",
"industry": ["4", "6"],
"openToWork": true
},
"count": 50,
"start": 0
}Location Filters
You can use either locationId or geoUrn:
// Option 1: Simple location ID
{
"filters": {
"locationId": "103644278" // San Francisco Bay Area
}
}
// Option 2: Full geo URN
{
"filters": {
"geoUrn": "urn:li:fsd_geo:103644278"
}
}Common LinkedIn Location IDs
| Location ID | Location |
|---|---|
"103644278" | United States |
"90000084" | San Francisco Bay Area |
"90009496" | New York City Metropolitan Area |
"90010383" | Greater London |
"102095887" | India |
"105015875" | Canada |
Filter Value Types
String Arrays
When a filter accepts an array of strings, provide them as JSON array:
{
"filters": {
"connectionDegree": ["F", "S"],
"industry": ["4", "6", "96"]
}
}Boolean Values
Boolean filters accept true or false:
{
"filters": {
"openToWork": true,
"easyApply": true
}
}OR Syntax for Titles
The title filter supports OR syntax for multiple titles:
{
"filters": {
"title": "CTO OR VP Engineering OR Engineering Director OR Chief Architect"
}
}Best Practices
- Start Broad, Then Narrow: Begin with general keywords, then add specific filters
- Use Connection Degree Wisely: 1st degree (
F) returns fewer but more relevant results - Combine Company Filters: Use both
company(name) andcurrentCompanyIds(IDs) for precision - Respect Pagination Limits: Maximum
countis 100, use pagination for larger result sets - Test Filter Combinations: Some filter combinations may return empty results
- Location Specificity: Use city-level location IDs for more targeted results
- Industry Codes: Find industry codes by searching LinkedIn's industry taxonomy
Response Structure
All search endpoints return a consistent response structure:
{
"success": true,
"people": [...], // or "jobs", "companies", "groups"
"pagination": {
"count": 25,
"start": 0,
"total": 1000
},
"hasMore": true
}Common Errors
Invalid Filter Values
{
"error": "Invalid filter value",
"details": "connectionDegree must be one of: F, S, O"
}Pagination Limits
{
"error": "Invalid count parameter",
"details": "count must be between 1 and 100"
}Missing Account
{
"error": "No LinkedIn account found",
"details": "Please provide accountId or set a default account"
}Complete Examples
Advanced People Search
{
"keywords": "machine learning engineer",
"filters": {
"title": "ML Engineer OR Machine Learning Engineer OR AI Engineer",
"currentCompanyIds": ["1441", "2382910"], // Google, Meta
"connectionDegree": ["S", "O"],
"locationId": "90000084", // SF Bay Area
"industry": ["4", "6"],
"openToWork": true,
"school": "Stanford University"
},
"count": 50,
"start": 0
}Advanced Job Search
{
"keywords": "senior backend engineer",
"filters": {
"workplaceType": ["2"], // Remote only
"experienceLevel": ["4", "5"], // Mid-Senior to Director
"jobType": ["F"], // Full-time only
"datePosted": "past-week",
"easyApply": true,
"salary": "$150,000+"
},
"count": 25,
"start": 0,
"sortBy": "date"
}Advanced Company Search
{
"keywords": "artificial intelligence",
"filters": {
"companySize": ["C", "D", "E"], // 51-1,000 employees
"industry": ["4", "6", "96"],
"locationId": "103644278" // United States
},
"count": 25,
"start": 0,
"sortBy": "relevance"
}