Search People
curl --request POST \
--url https://api.linkupapi.com/v2/profiles \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"account_id": "<string>",
"action": "<string>",
"params": {
"keyword": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>",
"company_name": "<string>",
"company_url": [
"<string>"
],
"past_company": [
"<string>"
],
"location": [
"<string>"
],
"school_url": [
"<string>"
],
"industry": [
"<string>"
],
"network": [
"<string>"
],
"connection_of": "<string>",
"follower_of": "<string>",
"fetch_invitation_state": true,
"total_results": 123,
"start_page": 123,
"end_page": 123
}
}
'{
"success": true,
"data": {
"results": [
{
"public_id": "janedoe",
"first_name": "Jane",
"last_name": "Doe",
"headline": "Software Engineer at TechCo",
"location": "San Francisco, CA",
"profile_picture_url": "https://media.licdn.com/dms/image/example.jpg",
"linkedin_url": "https://www.linkedin.com/in/janedoe",
"invitation_state": "CONNECTED"
},
{
"public_id": "bobsmith",
"first_name": "Bob",
"last_name": "Smith",
"headline": "Senior Developer at StartupXYZ",
"location": "San Francisco Bay Area",
"profile_picture_url": "https://media.licdn.com/dms/image/example2.jpg",
"linkedin_url": "https://www.linkedin.com/in/bobsmith",
"invitation_state": "PENDING"
}
],
"total_results": 2,
"total_available_results": 15400
},
"metadata": {
"action": "search_people",
"account_id": "your-account-id",
"credits_consumed": 2,
"timestamp": "2026-03-24T12:00:00Z"
}
}
Profiles
Search People
Search for profiles using various filters.
POST
/
v2
/
profiles
Search People
curl --request POST \
--url https://api.linkupapi.com/v2/profiles \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"account_id": "<string>",
"action": "<string>",
"params": {
"keyword": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>",
"company_name": "<string>",
"company_url": [
"<string>"
],
"past_company": [
"<string>"
],
"location": [
"<string>"
],
"school_url": [
"<string>"
],
"industry": [
"<string>"
],
"network": [
"<string>"
],
"connection_of": "<string>",
"follower_of": "<string>",
"fetch_invitation_state": true,
"total_results": 123,
"start_page": 123,
"end_page": 123
}
}
'{
"success": true,
"data": {
"results": [
{
"public_id": "janedoe",
"first_name": "Jane",
"last_name": "Doe",
"headline": "Software Engineer at TechCo",
"location": "San Francisco, CA",
"profile_picture_url": "https://media.licdn.com/dms/image/example.jpg",
"linkedin_url": "https://www.linkedin.com/in/janedoe",
"invitation_state": "CONNECTED"
},
{
"public_id": "bobsmith",
"first_name": "Bob",
"last_name": "Smith",
"headline": "Senior Developer at StartupXYZ",
"location": "San Francisco Bay Area",
"profile_picture_url": "https://media.licdn.com/dms/image/example2.jpg",
"linkedin_url": "https://www.linkedin.com/in/bobsmith",
"invitation_state": "PENDING"
}
],
"total_results": 2,
"total_available_results": 15400
},
"metadata": {
"action": "search_people",
"account_id": "your-account-id",
"credits_consumed": 2,
"timestamp": "2026-03-24T12:00:00Z"
}
}
Overview
Search for profiles using a combination of keyword, company, location, school, and other filters. Supports pagination for retrieving large result sets.This endpoint consumes 1 credit per 10 results returned.
Request
Your API key for authentication.
The unique identifier of the account to use.
Must be
"search_people".Show params properties
Show params properties
General keyword to search for across profiles.
Filter by first name.
Filter by last name.
Filter by current job title.
Filter by current company name.
Filter by company page URL. Accepts a single string or an array of strings for multiple companies.
Filter by past company name or URL. Accepts a single string or an array.
Filter by location (e.g.,
"San Francisco", ["Paris", "London"]). Accepts a single string or an array.Filter by school page URL. Accepts a single string or an array.
Filter by industry. Accepts a single string or an array.
Filter by network relationship. Accepted values:
"F" (1st degree), "S" (2nd degree), "O" (3rd degree and beyond). Accepts a single string or an array (e.g., ["F", "S"]).Filter to show connections of a specific profile (profile URL or identifier).
Filter to show followers of a specific company or profile.
Whether to include invitation state for each result. Defaults to
true.Total number of results to return. Defaults to
10.Start page for pagination (1-indexed). Use with
end_page for pagination mode.End page for pagination (inclusive). Use with
start_page for pagination mode.Response
Indicates whether the request was successful.
Show data properties
Show data properties
List of matching profiles.
Show result item properties
Show result item properties
The public identifier.
First name.
Last name.
Profile headline.
Location.
URL of the profile picture.
Full profile URL.
Connection invitation state (if
fetch_invitation_state is true).Number of results returned.
Total number of matching results available.
{
"success": true,
"data": {
"results": [
{
"public_id": "janedoe",
"first_name": "Jane",
"last_name": "Doe",
"headline": "Software Engineer at TechCo",
"location": "San Francisco, CA",
"profile_picture_url": "https://media.licdn.com/dms/image/example.jpg",
"linkedin_url": "https://www.linkedin.com/in/janedoe",
"invitation_state": "CONNECTED"
},
{
"public_id": "bobsmith",
"first_name": "Bob",
"last_name": "Smith",
"headline": "Senior Developer at StartupXYZ",
"location": "San Francisco Bay Area",
"profile_picture_url": "https://media.licdn.com/dms/image/example2.jpg",
"linkedin_url": "https://www.linkedin.com/in/bobsmith",
"invitation_state": "PENDING"
}
],
"total_results": 2,
"total_available_results": 15400
},
"metadata": {
"action": "search_people",
"account_id": "your-account-id",
"credits_consumed": 2,
"timestamp": "2026-03-24T12:00:00Z"
}
}
Was this page helpful?
⌘I