Search People

Search for people by name, location, or other criteria.

Curl

cURL 'https://api.enrich.so/v1/api/search-people' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "first_name": "John",
  "last_name": "Doe",
  "summary": "Experienced software engineer",
  "sub_title": "Tech Lead",
  "location_country": "United States",
  "location_city": "San Francisco",
  "location_state": "California",
  "influencer": false,
  "premium": true,
  "language": "English",
  "industry": "Technology",
  "certifications": ["AWS Certified", "PMP"],
  "degree_names": ["Bachelor of Science"],
  "study_fields": ["Computer Science"],
  "school_names": ["Stanford University"],
  "current_companies": [12345],
  "past_companies": [67890],
  "current_job_titles": ["Software Engineer"],
  "past_job_titles": ["Junior Developer"],
  "skills": ["Java", "Python", "Cloud Computing"],
  "current_page": 1,
  "page_size": 10
}'

Javascript

const axios = require('axios');

const payload = {
    first_name: "John",
    last_name: "Doe",
    summary: "Experienced software engineer",
    sub_title: "Tech Lead",
    location_country: "United States",
    location_city: "San Francisco",
    location_state: "California",
    influencer: false,
    premium: true,
    language: "English",
    industry: "Technology",
    certifications: ["AWS Certified", "PMP"],
    degree_names: ["Bachelor of Science"],
    study_fields: ["Computer Science"],
    school_names: ["Stanford University"],
    current_companies: [12345],
    past_companies: [67890],
    current_job_titles: ["Software Engineer"],
    past_job_titles: ["Junior Developer"],
    skills: ["Java", "Python", "Cloud Computing"],
    current_page: 1,
    page_size: 10
};

axios.post('https://api.enrich.so/v1/api/search-people', payload, {
    headers: {
        accept: 'application/json',
        Authorization: 'Bearer <token>',
        'Content-Type': 'application/json'
    }
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error.response ? error.response.data : error.message);
  });

Python

import requests

url = 'https://api.enrich.so/v1/api/search-people'

payload = {
    "first_name": "John",
    "last_name": "Doe",
    "summary": "Experienced software engineer",
    "sub_title": "Tech Lead",
    "location_country": "United States",
    "location_city": "San Francisco",
    "location_state": "California",
    "influencer": False,
    "premium": True,
    "language": "English",
    "industry": "Technology",
    "certifications": ["AWS Certified", "PMP"],
    "degree_names": ["Bachelor of Science"],
    "study_fields": ["Computer Science"],
    "school_names": ["Stanford University"],
    "current_companies": [12345],
    "past_companies": [67890],
    "current_job_titles": ["Software Engineer"],
    "past_job_titles": ["Junior Developer"],
    "skills": ["Java", "Python", "Cloud Computing"],
    "current_page": 1,
    "page_size": 10
}

headers = {
    'accept': 'application/json',
    'authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}, {response.text}")

Java

OkHttpClient client = new OkHttpClient();

        MediaType mediaType = MediaType.parse("application/json");
        String payload = "{\n" +
                "  \"first_name\": \"John\",\n" +
                "  \"last_name\": \"Doe\",\n" +
                "  \"summary\": \"Experienced software engineer\",\n" +
                "  \"sub_title\": \"Tech Lead\",\n" +
                "  \"location_country\": \"United States\",\n" +
                "  \"location_city\": \"San Francisco\",\n" +
                "  \"location_state\": \"California\",\n" +
                "  \"influencer\": false,\n" +
                "  \"premium\": true,\n" +
                "  \"language\": \"English\",\n" +
                "  \"industry\": \"Technology\",\n" +
                "  \"certifications\": [\"AWS Certified\", \"PMP\"],\n" +
                "  \"degree_names\": [\"Bachelor of Science\"],\n" +
                "  \"study_fields\": [\"Computer Science\"],\n" +
                "  \"school_names\": [\"Stanford University\"],\n" +
                "  \"current_companies\": [12345],\n" +
                "  \"past_companies\": [67890],\n" +
                "  \"current_job_titles\": [\"Software Engineer\"],\n" +
                "  \"past_job_titles\": [\"Junior Developer\"],\n" +
                "  \"skills\": [\"Java\", \"Python\", \"Cloud Computing\"],\n" +
                "  \"current_page\": 1,\n" +
                "  \"page_size\": 10\n" +
                "}";

        RequestBody body = RequestBody.create(mediaType, payload);

        Request request = new Request.Builder()
                .url("https://api.enrich.so/v1/api/search-people")
                .post(body)
                .addHeader("accept", "application/json")
                .addHeader("authorization", "Bearer <token>")
                .addHeader("Content-Type", "application/json")
                .build();

        Response response = client.newCall(request).execute();

Ruby

require 'uri'
require 'net/http'
require 'json'

url = URI("https://api.enrich.so/v1/api/search-people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = 'application/json'
request["authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'

payload = {
  first_name: "John",
  last_name: "Doe",
  summary: "Experienced software engineer",
  sub_title: "Tech Lead",
  location_country: "United States",
  location_city: "San Francisco",
  location_state: "California",
  influencer: false,
  premium: true,
  language: "English",
  industry: "Technology",
  certifications: ["AWS Certified", "PMP"],
  degree_names: ["Bachelor of Science"],
  study_fields: ["Computer Science"],
  school_names: ["Stanford University"],
  current_companies: [12345],
  past_companies: [67890],
  current_job_titles: ["Software Engineer"],
  past_job_titles: ["Junior Developer"],
  skills: ["Java", "Python", "Cloud Computing"],
  current_page: 1,
  page_size: 10
}

request.body = payload.to_json

response = http.request(request)
if response.code == '200'
  puts response.body
else
  puts "Error: #{response.code}, #{response.body}"
end

Php

<?php

$curl = curl_init();

$data = [
    "first_name" => "John",
    "last_name" => "Doe",
    "summary" => "Experienced software engineer",
    "sub_title" => "Tech Lead",
    "location_country" => "United States",
    "location_city" => "San Francisco",
    "location_state" => "California",
    "influencer" => false,
    "premium" => true,
    "language" => "English",
    "industry" => "Technology",
    "certifications" => ["AWS Certified", "PMP"],
    "degree_names" => ["Bachelor of Science"],
    "study_fields" => ["Computer Science"],
    "school_names" => ["Stanford University"],
    "current_companies" => [12345],
    "past_companies" => [67890],
    "current_job_titles" => ["Software Engineer"],
    "past_job_titles" => ["Junior Developer"],
    "skills" => ["Java", "Python", "Cloud Computing"],
    "current_page" => 1,
    "page_size" => 10
];

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.enrich.so/v1/api/search-people",
    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($data),
    CURLOPT_HTTPHEADER => [
        "accept: application/json",
        "authorization: Bearer <token>",
        "Content-Type: application/json"
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}

Example response

Status Code: 200 OK

{
    "success": true,
    "message": "People record found.",
    "data": {
        "current_page": 2,
        "total_page": 3000,
        "page_size": 2,
        "profiles": [
            {
                "profile_identifier": "ananya-roy-123456789",
                "given_name": "Ananya",
                "family_name": "Roy",
                "current_position": "Research Scientist at QuantumLab",
                "profile_image": "https://randomuser.me/api/portraits/women/21.jpg",
                "external_profile_url": "https://www.linkedin.com/in/ananya-roy-123456789/",
                "residence": {
                    "city": "Bengaluru",
                    "country": "India"
                },
                "expert_skills": [
                    "Quantum Computing",
                    "Data Analysis",
                    "Algorithm Development",
                    "Scientific Research"
                ]
            },
            {
                "profile_identifier": "daniel-smith-987654321",
                "given_name": "Daniel",
                "family_name": "Smith",
                "current_position": "Creative Director at InnovateDesign",
                "profile_image": "https://randomuser.me/api/portraits/men/32.jpg",
                "external_profile_url": "https://www.linkedin.com/in/daniel-smith-987654321/",
                "residence": {
                    "city": "San Francisco",
                    "country": "USA"
                },
                "expert_skills": [
                    "Graphic Design",
                    "UX/UI Design",
                    "Brand Identity",
                    "Team Leadership",
                    "Creative Direction",
                    "Visual Storytelling",
                    "Marketing Strategy"
                ]
            }
        ]
    },
    "total_credits": 50000,
    "credits_used": 2547.75,
    "credits_remaining": 47452.25
}

Status code: 404 NOT FOUND

{
    "message": "We couldn't find the results for your query"
}