Search LinkedIn profiles

Full-text search across LinkedIn profile fields using BM25 ranking. Returns full profile data including employment, education, skills, and contact info. Requires PROFESSIONAL service. Credits: 1 per result returned.

post/search/li-users

Request body

querystring nullable required

Full-text search query across LinkedIn profile fields. Searches: full_name, headline, current_title, current_titles, current_title_at_company, titles, title_at_company, past_title_at_company, campuses, majors, major_at_campus, expertise, certifications. Supports: string (BM25 search), null (filter-only)

maxResultsinteger

Maximum number of results to return (default: 100, max: 1000)

firstinteger

Alias for maxResults (takes precedence if both provided)

enablePaginationboolean

Enable cursor-based pagination to fetch results across multiple requests

afterstring

Cursor for pagination (from previous response pageInfo.endCursor)

Example request

{
  "query": "senior software engineer machine learning",
  "maxResults": 50,
  "first": 50,
  "enablePagination": true,
  "after": "Y3Vyc29yOjEyMzQ1"
}

Response

Search results retrieved successfully

countnumber required

Number of profiles returned

Example response

{
  "liUsers": [
    {
      "id": "abc123def456",
      "linkedin_url": "https://linkedin.com/in/jdoe",
      "full_name": "Jane Doe",
      "score": 12.5,
      "github": {
        "id": "9f0b8901cf1848298a60a60083b5aac0",
        "githubId": "MDQ6VXNlcjU4MzIzMQ==",
        "login": "octocat",
        "displayName": "The Octocat",
        "bio": "I build things for GitHub",
        "company": "GitHub",
        "location": "San Francisco, CA",
        "websiteUrl": "https://github.blog",
        "socialAccounts": [
          {
            "provider": "twitter",
            "url": "https://twitter.com/github"
          }
        ],
        "emails": [
          "***at@github.com",
          "***hn@gmail.com"
        ],
        "resolvedCountry": "United States",
        "resolvedState": "California",
        "resolvedCity": "San Francisco",
        "createdAt": "2011-01-25T18:44:36Z",
        "updatedAt": "2024-01-15T12:30:00Z",
        "embeddedAt": "2024-01-15T14:00:00Z",
        "score": 0.12,
        "aggregates": {
          "totalStars": 12500
        }
      }
    }
  ],
  "count": 25
}

Changes

Changed in 4 of the 43 revisions of this API.26

Feb 26, 20260d3c77ff90a711See the full diff
- ▲
  removed subschema #1 subschema #2 subschema #3 from the filters request property anyOf list
  request-property-any-of-removed
- ○
  added subschema #1 subschema #2 subschema #3 to the filters request property anyOf list
  request-property-any-of-added
Feb 25, 20262252c9de5d2d2See the full diff
- ○
  added the new optional request property includeAttributes
  new-optional-request-property
- ○
  added the optional property liUsers/items/github to the response with the 200 status
  response-optional-property-added
Feb 24, 2026d614b3e4407d12See the full diff
- ▲
  removed subschema #3 subschema #4 subschema #5 subschema #6 subschema #7 subschema #8 subschema #9 from the rankBy/allOf[RankExpr]/ request property oneOf list
  request-property-one-of-removed
- ○
  removed discriminator from rankBy/allOf[RankExpr]/ request property
  request-property-discriminator-removed
- ○
  added subschema #3 subschema #4 subschema #5 subschema #6 subschema #7 subschema #8 subschema #9 subschema #10 to the rankBy/allOf[RankExpr]/ request property oneOf list
  request-property-one-of-added
Feb 24, 20269ff7f78f577d1See the full diff
- ○
  endpoint added
  endpoint-added

Full history