Facebook Pixel

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

FilterTypeDescriptionExample
keywordsstringGeneral search keywords"software engineer"
firstNamestringFilter by first name"John"
lastNamestringFilter by last name"Doe"

Title & Company Filters

FilterTypeDescriptionExample
titlestringJob title with OR syntax support"Engineering Manager OR VP Engineering OR CTO"
companystringCompany name"Google"
currentCompanyIdsstring[]Array of LinkedIn company IDs for current employers["1441", "2063"]
pastCompanyIdsstring[]Array of LinkedIn company IDs for past employers["1441"]

Education & Location Filters

FilterTypeDescriptionExample
schoolstringSchool/university name"Stanford University"
locationIdstringLinkedIn location ID"103644278"
geoUrnstringFull LinkedIn geo URN"urn:li:fsd_geo:103644278"

Connection & Network Filters

FilterTypeValuesDescription
connectionDegreestring[]"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

FilterTypeDescriptionExample
industrystring[]Array of LinkedIn industry codes["4", "6", "96"]
profileLanguagestring[]Profile language codes (ISO 639-1)["en", "es", "fr"]
serviceCategoriesstring[]Service categories for professionals["consulting", "training"]
openToWorkbooleanFilter by "Open to Work" statustrue

Common LinkedIn Industry Codes

CodeIndustry
"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

FilterTypeDescriptionExample
keywordsstringSearch keywords"software engineer"
locationIdstringLinkedIn location ID"103644278"
geoUrnstringFull LinkedIn geo URN"urn:li:fsd_geo:103644278"
companyIdsstring[]Array of LinkedIn company IDs["1441", "2063"]

Job Type Filter

FilterTypeValuesDescription
jobTypestring[]"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

FilterTypeValuesDescription
experienceLevelstring[]"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

FilterTypeValuesDescription
workplaceTypestring[]"1", "2", "3"1 = On-site
2 = Remote
3 = Hybrid

Example:

{
  "workplaceType": ["2", "3"]  // Remote and Hybrid only
}

Date Posted Filter

FilterTypeValuesDescription
datePostedstring"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

FilterTypeDescriptionExample
salarystringSalary filter (LinkedIn format)"$100,000+"
industrystring[]Industry codes["4", "6"]
jobFunctionsstring[]Job function codes["eng", "it"]
titlesstring[]Job titles["Software Engineer", "Developer"]
benefitsstring[]Job benefits["health-insurance", "401k"]
commitmentsstring[]Commitment types["full-time-commitment"]
easyApplybooleanFilter by Easy Apply jobstrue

Company Search Filters

When searching for companies using /linkedin/search/companies, you can use the following filters:

Basic Filters

FilterTypeDescriptionExample
keywordsstringSearch keywords"technology startup"
locationIdstringLinkedIn location ID"103644278"
geoUrnstringFull LinkedIn geo URN"urn:li:fsd_geo:103644278"
industrystring[]Industry codes["4", "6", "96"]

Company Size Filter

FilterTypeValuesDescription
companySizestring[]"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

FilterTypeDescriptionExample
companyTypestring[]Company type identifiers["PUBLIC_COMPANY", "PRIVATELY_HELD"]
followedCompaniesbooleanFilter by companies you followtrue

Group Search Filters

When searching for groups using /linkedin/search/groups, you can use the following filters:

Basic Filters

FilterTypeDescriptionExample
keywordsstringSearch keywords"javascript developers"
memberCountstring"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 IDLocation
"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

  1. Start Broad, Then Narrow: Begin with general keywords, then add specific filters
  2. Use Connection Degree Wisely: 1st degree (F) returns fewer but more relevant results
  3. Combine Company Filters: Use both company (name) and currentCompanyIds (IDs) for precision
  4. Respect Pagination Limits: Maximum count is 100, use pagination for larger result sets
  5. Test Filter Combinations: Some filter combinations may return empty results
  6. Location Specificity: Use city-level location IDs for more targeted results
  7. 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

{
  "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
}
{
  "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"
}
{
  "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"
}