Skip to main content
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

x-api-key
string
required
Your API key for authentication

Body Parameters

keyword
string
Main search keyword (name, position, skills, etc.)
job_title
string
Job title to search for
industry
string
Industry sector (e.g., “technology”, “finance”, “healthcare”)
school
string
School or university
location
string
Location (city, country)
current_company
string
Current company
total_results
integer
default:"10"
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

status
string
Response status (“success” or “error”)
data
object
message
string
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