Search Profiles
curl --request POST \
--url https://api.linkupapi.com/v1/data/search/profiles \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"keyword": "<string>",
"job_title": "<string>",
"industry": "<string>",
"school": "<string>",
"location": "<string>",
"current_company": "<string>",
"total_results": 123
}
'import requests
url = "https://api.linkupapi.com/v1/data/search/profiles"
payload = {
"keyword": "<string>",
"job_title": "<string>",
"industry": "<string>",
"school": "<string>",
"location": "<string>",
"current_company": "<string>",
"total_results": 123
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
keyword: '<string>',
job_title: '<string>',
industry: '<string>',
school: '<string>',
location: '<string>',
current_company: '<string>',
total_results: 123
})
};
fetch('https://api.linkupapi.com/v1/data/search/profiles', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linkupapi.com/v1/data/search/profiles",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'keyword' => '<string>',
'job_title' => '<string>',
'industry' => '<string>',
'school' => '<string>',
'location' => '<string>',
'current_company' => '<string>',
'total_results' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v1/data/search/profiles"
payload := strings.NewReader("{\n \"keyword\": \"<string>\",\n \"job_title\": \"<string>\",\n \"industry\": \"<string>\",\n \"school\": \"<string>\",\n \"location\": \"<string>\",\n \"current_company\": \"<string>\",\n \"total_results\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/data/search/profiles")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"keyword\": \"<string>\",\n \"job_title\": \"<string>\",\n \"industry\": \"<string>\",\n \"school\": \"<string>\",\n \"location\": \"<string>\",\n \"current_company\": \"<string>\",\n \"total_results\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/data/search/profiles")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"keyword\": \"<string>\",\n \"job_title\": \"<string>\",\n \"industry\": \"<string>\",\n \"school\": \"<string>\",\n \"location\": \"<string>\",\n \"current_company\": \"<string>\",\n \"total_results\": 123\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"total_results": 1523,
"profiles": [
{
"url": "https://www.linkedin.com/in/johnperez",
"title": "John M P. - CRM Experts Online - LinkedIn",
"description": "As the founder of CRM Experts Online, I leverage my 19+ years of experience in enterprise… · Experience: CRM Experts Online · Education: New York College Of ..."
},
{
"url": "https://www.linkedin.com/in/brentleary",
"title": "Brent Leary - CRM Essentials - LinkedIn",
"description": "Brent Leary is Co-founder and Partner of CRM Essentials LLC, a CRM consulting/advisory… · Experience: CRM Essentials · Location: Stockbridge · 500+ ..."
},
{
"url": "https://www.linkedin.com/in/jsrosenth",
"title": "Jeff Rosenthal - Head of CRM GTM, North America - monday.com",
"description": "I lead GTM for an emerging portfolio of CRM & AI products at monday.com. Deep expertise in CRM & AI GTM as a trusted advisor to global go to market, sales, ..."
}
]
}
}
Person API
Search Profiles
Search LinkedIn profiles with multiple criteria
POST
/
v1
/
data
/
search
/
profiles
Search Profiles
curl --request POST \
--url https://api.linkupapi.com/v1/data/search/profiles \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"keyword": "<string>",
"job_title": "<string>",
"industry": "<string>",
"school": "<string>",
"location": "<string>",
"current_company": "<string>",
"total_results": 123
}
'import requests
url = "https://api.linkupapi.com/v1/data/search/profiles"
payload = {
"keyword": "<string>",
"job_title": "<string>",
"industry": "<string>",
"school": "<string>",
"location": "<string>",
"current_company": "<string>",
"total_results": 123
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
keyword: '<string>',
job_title: '<string>',
industry: '<string>',
school: '<string>',
location: '<string>',
current_company: '<string>',
total_results: 123
})
};
fetch('https://api.linkupapi.com/v1/data/search/profiles', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linkupapi.com/v1/data/search/profiles",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'keyword' => '<string>',
'job_title' => '<string>',
'industry' => '<string>',
'school' => '<string>',
'location' => '<string>',
'current_company' => '<string>',
'total_results' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v1/data/search/profiles"
payload := strings.NewReader("{\n \"keyword\": \"<string>\",\n \"job_title\": \"<string>\",\n \"industry\": \"<string>\",\n \"school\": \"<string>\",\n \"location\": \"<string>\",\n \"current_company\": \"<string>\",\n \"total_results\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/data/search/profiles")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"keyword\": \"<string>\",\n \"job_title\": \"<string>\",\n \"industry\": \"<string>\",\n \"school\": \"<string>\",\n \"location\": \"<string>\",\n \"current_company\": \"<string>\",\n \"total_results\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/data/search/profiles")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"keyword\": \"<string>\",\n \"job_title\": \"<string>\",\n \"industry\": \"<string>\",\n \"school\": \"<string>\",\n \"location\": \"<string>\",\n \"current_company\": \"<string>\",\n \"total_results\": 123\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"total_results": 1523,
"profiles": [
{
"url": "https://www.linkedin.com/in/johnperez",
"title": "John M P. - CRM Experts Online - LinkedIn",
"description": "As the founder of CRM Experts Online, I leverage my 19+ years of experience in enterprise… · Experience: CRM Experts Online · Education: New York College Of ..."
},
{
"url": "https://www.linkedin.com/in/brentleary",
"title": "Brent Leary - CRM Essentials - LinkedIn",
"description": "Brent Leary is Co-founder and Partner of CRM Essentials LLC, a CRM consulting/advisory… · Experience: CRM Essentials · Location: Stockbridge · 500+ ..."
},
{
"url": "https://www.linkedin.com/in/jsrosenth",
"title": "Jeff Rosenthal - Head of CRM GTM, North America - monday.com",
"description": "I lead GTM for an emerging portfolio of CRM & AI products at monday.com. Deep expertise in CRM & AI GTM as a trusted advisor to global go to market, sales, ..."
}
]
}
}
Description
This endpoint allows you to search LinkedIn profiles using different search criteria.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
Headers
Your API key for authentication
Body Parameters
Main search keyword (name, position, skills, etc.)
Job title to search for
Industry sector (e.g., “technology”, “finance”, “healthcare”)
School or university
Location (city, country)
Current company
Number of results to return
- Minimum: 1
- Maximum: 50,000
- Default: 10
At least one search criteria must be provided among:
keyword, job_title, industry, school, location, or current_company.Response
Response status (“success” or “error”)
Error message (if status = “error”)
Request Example
import requests
url = "https://api.linkupapi.com/v1/data/search/profiles"
payload = {
"keyword": "developer",
"job_title": "Software Engineer",
"industry": "Technology",
"location": "Paris",
"current_company": "Microsoft",
"total_results": 15
}
headers = {
"x-api-key": "your-api-key-here",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"keyword": "developer",
"job_title": "Software Engineer",
"industry": "Technology",
"location": "Paris",
"current_company": "Microsoft",
"total_results": 15
}
Request Example with Arrays
import requests
url = "https://api.linkupapi.com/v1/data/search/profiles"
payload = {
"keyword": ["developer", "engineer", "programmer"],
"job_title": ["Software Engineer", "Frontend Developer"],
"industry": ["Technology", "Finance"],
"location": ["Paris", "Lyon", "Marseille"],
"current_company": ["Microsoft", "Google", "Apple"],
"total_results": 20
}
headers = {
"x-api-key": "your-api-key-here",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"keyword": ["developer", "engineer", "programmer"],
"job_title": ["Software Engineer", "Frontend Developer"],
"industry": ["Technology", "Finance"],
"location": ["Paris", "Lyon", "Marseille"],
"current_company": ["Microsoft", "Google", "Apple"],
"total_results": 20
}
Response Example
{
"status": "success",
"data": {
"total_results": 1523,
"profiles": [
{
"url": "https://www.linkedin.com/in/johnperez",
"title": "John M P. - CRM Experts Online - LinkedIn",
"description": "As the founder of CRM Experts Online, I leverage my 19+ years of experience in enterprise… · Experience: CRM Experts Online · Education: New York College Of ..."
},
{
"url": "https://www.linkedin.com/in/brentleary",
"title": "Brent Leary - CRM Essentials - LinkedIn",
"description": "Brent Leary is Co-founder and Partner of CRM Essentials LLC, a CRM consulting/advisory… · Experience: CRM Essentials · Location: Stockbridge · 500+ ..."
},
{
"url": "https://www.linkedin.com/in/jsrosenth",
"title": "Jeff Rosenthal - Head of CRM GTM, North America - monday.com",
"description": "I lead GTM for an emerging portfolio of CRM & AI products at monday.com. Deep expertise in CRM & AI GTM as a trusted advisor to global go to market, sales, ..."
}
]
}
}
{
"status": "error",
"message": "At least one search criteria must be provided"
}
Usage Examples
Search by position and location
{
"job_title": "Data Scientist",
"location": "Lyon",
"total_results": 10
}
Search by school and industry
{
"school": "Harvard University",
"industry": "Finance",
"total_results": 20
}
Search by company and keyword
{
"current_company": "Microsoft",
"keyword": "artificial intelligence",
"total_results": 25
}
Batch search with multiple keywords
{
"keyword": ["data scientist", "machine learning engineer", "AI researcher"],
"location": ["Paris", "Lyon"],
"industry": ["Technology", "Healthcare"],
"total_results": 50
}
Advanced search with multiple criteria
{
"job_title": ["Software Engineer", "Full Stack Developer"],
"current_company": ["Google", "Microsoft", "Apple"],
"location": ["Paris", "London", "Berlin"],
"industry": "Technology",
"total_results": 40
}
Search with specific number of results
{
"keyword": "data scientist",
"location": "Paris",
"total_results": 15
}
Important Notes
- Credit consumption is based on the number of results: 1 credit for 1-10 results, 2 credits for 11-20 results, etc.
- Credits are only deducted on successful searches
- Single keyword: Advanced search with optional filters for precise results
- Multiple keywords: Automatically activates batch mode for parallel searching
- Too many keywords can hurt search relevance - it’s better to focus on 2-3 key terms rather than overloading the query.
- All search parameters support both single strings and arrays for flexible searching
Was this page helpful?
⌘I