Sign in

v43

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-0520621.8 MB

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
}