POST
/
v1
/
profile
/
search
curl --request POST \
  --url https://api.linkupapi.com/v1/profile/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "company_url": "<string>",
  "location": "<string>",
  "school_url": "<string>",
  "network": "<string>",
  "keyword": "<string>",
  "total_results": 123,
  "start_page": 123,
  "end_page": 123,
  "country": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "title": "<string>",
  "login_token": "<string>"
}'
{
  "status": "success",
  "data": {
    "total_results": 2,
    "total_available_results": 827,
    "profiles": [
      {
        "name": "John Doe",
        "job_title": "Software Engineer at Tech Company",
        "connection_level": "2nd",
        "location": "San Francisco Bay Area",
        "profile_url": "https://www.linkedin.com/in/johndoe/",
        "profile_picture": "https://media.licdn.com/dms/image/v2/example.jpg"
      },
      {
        "name": "Jane Smith",
        "job_title": "Product Manager at Innovative Solutions",
        "connection_level": "3rd",
        "location": "New York Metropolitan Area",
        "profile_url": "https://www.linkedin.com/in/janesmith/",
        "profile_picture": null
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 1,
      "results_per_page": 50,
      "pages_fetched": 1
    }
  }
}

Search for LinkedIn profiles using multiple filters including company, location, school, network, and keywords.

Credit Usage: 1 credit per 10 results (or fraction thereof). For example:

  • 1-10 results = 1 credit
  • 11-20 results = 2 credits
  • 300 results = 30 credits

​
Header Parameters

​
x-api-key
string
required

Your API key

​
Body Parameters

​
company_url
string

LinkedIn company URL or identifier to filter by current company. Use semicolon (;) as separator for multiple companies (e.g., “google;microsoft;apple”).

​
location
string

Geographic location to filter profiles. Use semicolon (;) as separator for multiple locations (e.g., “Paris;London;New York”).

​
school_url
string

LinkedIn school URL or identifier to filter by education. Use semicolon (;) as separator for multiple schools (e.g., “harvard;stanford;mit”).

​
network
string

Network connection level to filter by:

  • “F” = First-degree connections (1st)
  • “S” = Second-degree connections (2nd)
  • “O” = Out-of-network connections (3rd+) Use (,) as separator for multiple, eg: F,S,O
​
keyword
string

Search keyword to find relevant profiles

​
total_results
integer
default:"10"

Number of profiles to retrieve (used when not in pagination mode)

​
start_page
integer

First page to fetch when using pagination mode (default: 1)

​
end_page
integer

Last page to fetch when using pagination mode (default: same as start_page)

​
country
string
default:"FR"

Country code for proxy selection. Available: (US,UK,FR)

​
first_name
string
default:""

First name parameter in advanced keyword

​
last_name
string
default:""

Last name parameter in advanced keyword

​
title
string
default:""

Title text parameter in advanced keyword

​
login_token
string
required

LinkedIn authentication cookie obtained from the login/verify process

​
Response

​
status
string

Request status (success/error)

​
data
object
{
  "status": "success",
  "data": {
    "total_results": 2,
    "total_available_results": 827,
    "profiles": [
      {
        "name": "John Doe",
        "job_title": "Software Engineer at Tech Company",
        "connection_level": "2nd",
        "location": "San Francisco Bay Area",
        "profile_url": "https://www.linkedin.com/in/johndoe/",
        "profile_picture": "https://media.licdn.com/dms/image/v2/example.jpg"
      },
      {
        "name": "Jane Smith",
        "job_title": "Product Manager at Innovative Solutions",
        "connection_level": "3rd",
        "location": "New York Metropolitan Area",
        "profile_url": "https://www.linkedin.com/in/janesmith/",
        "profile_picture": null
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 1,
      "results_per_page": 50,
      "pages_fetched": 1
    }
  }
}

​
Notes

  • Company and school identifiers can be either:
  • Location search supports:
    • Cities
    • Regions
    • Countries
    • Market areas
  • Profile pictures are direct links to LinkedIn’s media servers
  • Missing information is marked as ‘N/A’
  • Profile pictures may be null if not available or restricted
  • The total_available_results field shows the total number of profiles that match your search criteria on LinkedIn
  • Results are paginated with a maximum of 50 profiles per page
  • Pagination Mode vs. Total Results Mode:
    • Total Results Mode: Use the total_results parameter to specify how many profiles you want (default)
    • Pagination Mode: Use start_page and end_page parameters to fetch specific pages of results
    • Credit usage in pagination mode is based on the number of pages fetched (1 credit per page)
    • When using pagination mode, total_results parameter is ignored
  • Search results may be limited by:
    • LinkedIn’s visibility settings
    • Your network connection level
    • Profile privacy settings
  • Search restrictions:
    • Rate limits apply