POST
/
v1
/
profile
/
search
Search Profile
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>",
  "fetch_invitation_state": true
}'
{
  "status": "success",
  "data": {
    "total_results": 2,
    "total_available_results": 827,
    "profiles": [
      {
        "name": "John Doe",
        "job_title": "Software Engineer at Tech Company",
        "connection_level": "2nd degree",
        "location": "San Francisco Bay Area",
        "profile_url": "https://www.linkedin.com/in/johndoe/",
        "profile_picture": "https://media.licdn.com/dms/image/v2/example.jpg",
        "invitation_state": "CAN_INVITE"
      },
      {
        "name": "Jane Smith",
        "job_title": "Product Manager at Innovative Solutions",
        "connection_level": "3rd+ degree",
        "location": "New York Metropolitan Area",
        "profile_url": "https://www.linkedin.com/in/janesmith/",
        "profile_picture": null,
        "invitation_state": "INVITATION_SENT"
      }
    ],
    "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
​
fetch_invitation_state
boolean
default:"true"
Whether to fetch the invitation state for each profile. When set to true, the response will include the current invitation/connection status for each profile.

​
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 degree",
        "location": "San Francisco Bay Area",
        "profile_url": "https://www.linkedin.com/in/johndoe/",
        "profile_picture": "https://media.licdn.com/dms/image/v2/example.jpg",
        "invitation_state": "CAN_INVITE"
      },
      {
        "name": "Jane Smith",
        "job_title": "Product Manager at Innovative Solutions",
        "connection_level": "3rd+ degree",
        "location": "New York Metropolitan Area",
        "profile_url": "https://www.linkedin.com/in/janesmith/",
        "profile_picture": null,
        "invitation_state": "INVITATION_SENT"
      }
    ],
    "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
  • Invitation State Feature:
    • When fetch_invitation_state is enabled (default), the API makes additional requests to determine the current invitation/connection status
    • This feature helps you understand whether you can send connection requests to specific profiles
    • Setting fetch_invitation_state to false will improve response time but won’t include invitation status information
    • Invitation states are determined in real-time and reflect the current LinkedIn relationship status
  • Search results may be limited by:
    • LinkedIn’s visibility settings
    • Your network connection level
    • Profile privacy settings
  • Search restrictions:
    • Rate limits apply