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
    }
  }
}

POST

profile

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”).

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

Show Properties

total_results

integer

Number of profiles returned in the response

total_available_results

integer

Total number of profiles available in LinkedIn matching your search criteria

profiles

array

Show Profile Object

name

string

Full name of the person

job_title

string

Current job title or headline

connection_level

string

Connection level with the profile owner. Possible values:

“1st degree” (Direct connection)
“2nd degree” (Connection through mutual contact)
“3rd+ degree” (Connection through multiple intermediaries)
“Out of network” (No connection path)

location

string

Geographic location

profile_url

string

LinkedIn profile URL

profile_picture

string

URL of the profile picture (if available, may be null)

invitation_state

string

Current invitation/connection status with this profile. Possible values:

“CAN_INVITE” (Can send connection request)
“INVITATION_SENT” (Connection request already sent)
“CONNECTED” (Already connected)
“UNKNOWN” (Status could not be determined)
“NOT_FETCHED” (Status not retrieved - when fetch_invitation_state is false)

pagination

object

Show Pagination 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:
- Full LinkedIn URLs (https://www.linkedin.com/company/…)
- Company/school names or identifiers
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

​Header Parameters

​Body Parameters

​Response

​Notes

Header Parameters

Body Parameters

Response

Notes