Skip to main content
POST
https://api.linkupapi.com
/
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>",
  "connection_of": "<string>",
  "industry": "<string>",
  "past_company": "<string>",
  "follower_of": "<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,
      "has_next_page":false
    }
  }
}
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, DE, NL, IT, IL, CA, BR, ES, IN)
​
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
​
connection_of
string
LinkedIn profile URL(s) to filter by their connections. Use semicolon (;) as separator for multiple profiles (e.g., “https://www.linkedin.com/in/john-doe;https://www.linkedin.com/in/jane-doe”).
Important for connection_of filter: You must be connected (1st degree) with the target profile to use this filter effectively. If you are not connected, the API will return profiles that you have in common as mutual connections with that person, not their full connection list.
​
industry
string
Industry to filter profiles by. Use semicolon (;) as separator for multiple industries (e.g., “software;marketing;finance”).Get the full list of available industries at: api.linkupapi.com/v1/tool/industries
​
past_company
string
LinkedIn company URL or identifier to filter by past/previous company. Use semicolon (;) as separator for multiple companies (e.g., “Google;Microsoft;Amazon”).
​
follower_of
string
LinkedIn profile URL(s) to filter by followers of that profile. Use semicolon (;) as separator for multiple profiles (e.g., “https://www.linkedin.com/in/john-doe;https://www.linkedin.com/in/jane-doe”).
​
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,
      "has_next_page":false
    }
  }
}

​
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
  • Search restrictions:
    • Rate limits apply