Search People

Search for people based on various filters. Multiple filters within the same field are combined with AND logic.

POST /people/search

Search people

cURL

curl --request POST \
  --url https://app.fullenrich.com/api/v2/people/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "offset": 0,
  "limit": 20,
  "current_company_names": [
    {
      "value": "Anthropic",
      "exact_match": true,
      "exclude": false
    },
    {
      "value": "OpenAI",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_domains": [
    {
      "value": "google.com",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_linkedin_urls": [
    {
      "value": "https://www.linkedin.com/company/fullenrich",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_specialties": [
    {
      "value": "artificial intelligence",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_industries": [
    {
      "value": "Software Development",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "Computer Hardware Manufacturing",
      "exact_match": false,
      "exclude": false
    }
  ],
  "past_company_names": [
    {
      "value": "Meta",
      "exact_match": true,
      "exclude": false
    }
  ],
  "past_company_domains": [
    {
      "value": "facebook.com",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_types": [
    {
      "value": "Public Company",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_headquarters": [
    {
      "value": "San Francisco",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "New York",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_company_headcounts": [
    {
      "min": 50,
      "max": 200,
      "exclude": false
    },
    {
      "min": 1000,
      "max": 5000,
      "exclude": false
    }
  ],
  "current_company_founded_years": [
    {
      "min": 2020,
      "max": 2024,
      "exclude": false
    }
  ],
  "current_company_ids": [
    {
      "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "exclude": false,
      "exact_match": true
    }
  ],
  "person_ids": [
    {
      "value": "746e4816-19c8-54d8-b558-65a5a52cc85c",
      "exclude": false,
      "exact_match": true
    }
  ],
  "person_names": [
    {
      "value": "John Smith",
      "exact_match": false,
      "exclude": false
    }
  ],
  "person_linkedin_urls": [
    {
      "value": "https://www.linkedin.com/in/john-doe",
      "exact_match": true,
      "exclude": false
    }
  ],
  "person_locations": [
    {
      "value": "San Francisco",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "California",
      "exact_match": false,
      "exclude": false
    }
  ],
  "person_skills": [
    {
      "value": "JavaScript",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "Python",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "Project Management",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_seniority_level": [
    {
      "value": "Director",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "VP",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_titles": [
    {
      "value": "Chief Technology Officer",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "VP of Engineering",
      "exact_match": false,
      "exclude": false
    }
  ],
  "past_position_titles": [
    {
      "value": "Software Engineer",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_years_in": [
    {
      "min": 0,
      "max": 1,
      "exclude": false
    }
  ],
  "current_company_years_at": [
    {
      "min": 2,
      "max": 5,
      "exclude": false
    }
  ],
  "person_universities": [
    {
      "value": "Stanford University",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "MIT",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_company_days_since_last_job_change": [
    {
      "min": 0,
      "max": 90,
      "exclude": false
    }
  ]
}
'

import requests

url = "https://app.fullenrich.com/api/v2/people/search"

payload = {
    "offset": 0,
    "limit": 20,
    "current_company_names": [
        {
            "value": "Anthropic",
            "exact_match": True,
            "exclude": False
        },
        {
            "value": "OpenAI",
            "exact_match": True,
            "exclude": False
        }
    ],
    "current_company_domains": [
        {
            "value": "google.com",
            "exact_match": True,
            "exclude": False
        }
    ],
    "current_company_linkedin_urls": [
        {
            "value": "https://www.linkedin.com/company/fullenrich",
            "exact_match": True,
            "exclude": False
        }
    ],
    "current_company_specialties": [
        {
            "value": "artificial intelligence",
            "exact_match": True,
            "exclude": False
        }
    ],
    "current_company_industries": [
        {
            "value": "Software Development",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "Computer Hardware Manufacturing",
            "exact_match": False,
            "exclude": False
        }
    ],
    "past_company_names": [
        {
            "value": "Meta",
            "exact_match": True,
            "exclude": False
        }
    ],
    "past_company_domains": [
        {
            "value": "facebook.com",
            "exact_match": True,
            "exclude": False
        }
    ],
    "current_company_types": [
        {
            "value": "Public Company",
            "exact_match": True,
            "exclude": False
        }
    ],
    "current_company_headquarters": [
        {
            "value": "San Francisco",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "New York",
            "exact_match": False,
            "exclude": False
        }
    ],
    "current_company_headcounts": [
        {
            "min": 50,
            "max": 200,
            "exclude": False
        },
        {
            "min": 1000,
            "max": 5000,
            "exclude": False
        }
    ],
    "current_company_founded_years": [
        {
            "min": 2020,
            "max": 2024,
            "exclude": False
        }
    ],
    "current_company_ids": [
        {
            "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "exclude": False,
            "exact_match": True
        }
    ],
    "person_ids": [
        {
            "value": "746e4816-19c8-54d8-b558-65a5a52cc85c",
            "exclude": False,
            "exact_match": True
        }
    ],
    "person_names": [
        {
            "value": "John Smith",
            "exact_match": False,
            "exclude": False
        }
    ],
    "person_linkedin_urls": [
        {
            "value": "https://www.linkedin.com/in/john-doe",
            "exact_match": True,
            "exclude": False
        }
    ],
    "person_locations": [
        {
            "value": "San Francisco",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "California",
            "exact_match": False,
            "exclude": False
        }
    ],
    "person_skills": [
        {
            "value": "JavaScript",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "Python",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "Project Management",
            "exact_match": False,
            "exclude": False
        }
    ],
    "current_position_seniority_level": [
        {
            "value": "Director",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "VP",
            "exact_match": False,
            "exclude": False
        }
    ],
    "current_position_titles": [
        {
            "value": "Chief Technology Officer",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "VP of Engineering",
            "exact_match": False,
            "exclude": False
        }
    ],
    "past_position_titles": [
        {
            "value": "Software Engineer",
            "exact_match": False,
            "exclude": False
        }
    ],
    "current_position_years_in": [
        {
            "min": 0,
            "max": 1,
            "exclude": False
        }
    ],
    "current_company_years_at": [
        {
            "min": 2,
            "max": 5,
            "exclude": False
        }
    ],
    "person_universities": [
        {
            "value": "Stanford University",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "MIT",
            "exact_match": False,
            "exclude": False
        }
    ],
    "current_company_days_since_last_job_change": [
        {
            "min": 0,
            "max": 90,
            "exclude": False
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    offset: 0,
    limit: 20,
    current_company_names: [
      {value: 'Anthropic', exact_match: true, exclude: false},
      {value: 'OpenAI', exact_match: true, exclude: false}
    ],
    current_company_domains: [{value: 'google.com', exact_match: true, exclude: false}],
    current_company_linkedin_urls: [
      {
        value: 'https://www.linkedin.com/company/fullenrich',
        exact_match: true,
        exclude: false
      }
    ],
    current_company_specialties: [{value: 'artificial intelligence', exact_match: true, exclude: false}],
    current_company_industries: [
      {value: 'Software Development', exact_match: false, exclude: false},
      {value: 'Computer Hardware Manufacturing', exact_match: false, exclude: false}
    ],
    past_company_names: [{value: 'Meta', exact_match: true, exclude: false}],
    past_company_domains: [{value: 'facebook.com', exact_match: true, exclude: false}],
    current_company_types: [{value: 'Public Company', exact_match: true, exclude: false}],
    current_company_headquarters: [
      {value: 'San Francisco', exact_match: false, exclude: false},
      {value: 'New York', exact_match: false, exclude: false}
    ],
    current_company_headcounts: [{min: 50, max: 200, exclude: false}, {min: 1000, max: 5000, exclude: false}],
    current_company_founded_years: [{min: 2020, max: 2024, exclude: false}],
    current_company_ids: [
      {
        value: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
        exclude: false,
        exact_match: true
      }
    ],
    person_ids: [
      {
        value: '746e4816-19c8-54d8-b558-65a5a52cc85c',
        exclude: false,
        exact_match: true
      }
    ],
    person_names: [{value: 'John Smith', exact_match: false, exclude: false}],
    person_linkedin_urls: [
      {
        value: 'https://www.linkedin.com/in/john-doe',
        exact_match: true,
        exclude: false
      }
    ],
    person_locations: [
      {value: 'San Francisco', exact_match: false, exclude: false},
      {value: 'California', exact_match: false, exclude: false}
    ],
    person_skills: [
      {value: 'JavaScript', exact_match: false, exclude: false},
      {value: 'Python', exact_match: false, exclude: false},
      {value: 'Project Management', exact_match: false, exclude: false}
    ],
    current_position_seniority_level: [
      {value: 'Director', exact_match: false, exclude: false},
      {value: 'VP', exact_match: false, exclude: false}
    ],
    current_position_titles: [
      {value: 'Chief Technology Officer', exact_match: false, exclude: false},
      {value: 'VP of Engineering', exact_match: false, exclude: false}
    ],
    past_position_titles: [{value: 'Software Engineer', exact_match: false, exclude: false}],
    current_position_years_in: [{min: 0, max: 1, exclude: false}],
    current_company_years_at: [{min: 2, max: 5, exclude: false}],
    person_universities: [
      {value: 'Stanford University', exact_match: false, exclude: false},
      {value: 'MIT', exact_match: false, exclude: false}
    ],
    current_company_days_since_last_job_change: [{min: 0, max: 90, exclude: false}]
  })
};

fetch('https://app.fullenrich.com/api/v2/people/search', 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://app.fullenrich.com/api/v2/people/search",
  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([
    'offset' => 0,
    'limit' => 20,
    'current_company_names' => [
        [
                'value' => 'Anthropic',
                'exact_match' => true,
                'exclude' => false
        ],
        [
                'value' => 'OpenAI',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'current_company_domains' => [
        [
                'value' => 'google.com',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'current_company_linkedin_urls' => [
        [
                'value' => 'https://www.linkedin.com/company/fullenrich',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'current_company_specialties' => [
        [
                'value' => 'artificial intelligence',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'current_company_industries' => [
        [
                'value' => 'Software Development',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'Computer Hardware Manufacturing',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'past_company_names' => [
        [
                'value' => 'Meta',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'past_company_domains' => [
        [
                'value' => 'facebook.com',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'current_company_types' => [
        [
                'value' => 'Public Company',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'current_company_headquarters' => [
        [
                'value' => 'San Francisco',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'New York',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'current_company_headcounts' => [
        [
                'min' => 50,
                'max' => 200,
                'exclude' => false
        ],
        [
                'min' => 1000,
                'max' => 5000,
                'exclude' => false
        ]
    ],
    'current_company_founded_years' => [
        [
                'min' => 2020,
                'max' => 2024,
                'exclude' => false
        ]
    ],
    'current_company_ids' => [
        [
                'value' => 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
                'exclude' => false,
                'exact_match' => true
        ]
    ],
    'person_ids' => [
        [
                'value' => '746e4816-19c8-54d8-b558-65a5a52cc85c',
                'exclude' => false,
                'exact_match' => true
        ]
    ],
    'person_names' => [
        [
                'value' => 'John Smith',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'person_linkedin_urls' => [
        [
                'value' => 'https://www.linkedin.com/in/john-doe',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'person_locations' => [
        [
                'value' => 'San Francisco',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'California',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'person_skills' => [
        [
                'value' => 'JavaScript',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'Python',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'Project Management',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'current_position_seniority_level' => [
        [
                'value' => 'Director',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'VP',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'current_position_titles' => [
        [
                'value' => 'Chief Technology Officer',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'VP of Engineering',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'past_position_titles' => [
        [
                'value' => 'Software Engineer',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'current_position_years_in' => [
        [
                'min' => 0,
                'max' => 1,
                'exclude' => false
        ]
    ],
    'current_company_years_at' => [
        [
                'min' => 2,
                'max' => 5,
                'exclude' => false
        ]
    ],
    'person_universities' => [
        [
                'value' => 'Stanford University',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'MIT',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'current_company_days_since_last_job_change' => [
        [
                'min' => 0,
                'max' => 90,
                'exclude' => false
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "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;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fullenrich.com/api/v2/people/search"

	payload := strings.NewReader("{\n  \"offset\": 0,\n  \"limit\": 20,\n  \"current_company_names\": [\n    {\n      \"value\": \"Anthropic\",\n      \"exact_match\": true,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"OpenAI\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_domains\": [\n    {\n      \"value\": \"google.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/company/fullenrich\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_specialties\": [\n    {\n      \"value\": \"artificial intelligence\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_industries\": [\n    {\n      \"value\": \"Software Development\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Computer Hardware Manufacturing\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"past_company_names\": [\n    {\n      \"value\": \"Meta\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"past_company_domains\": [\n    {\n      \"value\": \"facebook.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_types\": [\n    {\n      \"value\": \"Public Company\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_headquarters\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"New York\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_headcounts\": [\n    {\n      \"min\": 50,\n      \"max\": 200,\n      \"exclude\": false\n    },\n    {\n      \"min\": 1000,\n      \"max\": 5000,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_founded_years\": [\n    {\n      \"min\": 2020,\n      \"max\": 2024,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_ids\": [\n    {\n      \"value\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ],\n  \"person_ids\": [\n    {\n      \"value\": \"746e4816-19c8-54d8-b558-65a5a52cc85c\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ],\n  \"person_names\": [\n    {\n      \"value\": \"John Smith\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"person_linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/in/john-doe\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"person_locations\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"California\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"person_skills\": [\n    {\n      \"value\": \"JavaScript\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Python\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Project Management\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_seniority_level\": [\n    {\n      \"value\": \"Director\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"VP\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_titles\": [\n    {\n      \"value\": \"Chief Technology Officer\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"VP of Engineering\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"past_position_titles\": [\n    {\n      \"value\": \"Software Engineer\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_years_in\": [\n    {\n      \"min\": 0,\n      \"max\": 1,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_years_at\": [\n    {\n      \"min\": 2,\n      \"max\": 5,\n      \"exclude\": false\n    }\n  ],\n  \"person_universities\": [\n    {\n      \"value\": \"Stanford University\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"MIT\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_days_since_last_job_change\": [\n    {\n      \"min\": 0,\n      \"max\": 90,\n      \"exclude\": false\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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://app.fullenrich.com/api/v2/people/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"offset\": 0,\n  \"limit\": 20,\n  \"current_company_names\": [\n    {\n      \"value\": \"Anthropic\",\n      \"exact_match\": true,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"OpenAI\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_domains\": [\n    {\n      \"value\": \"google.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/company/fullenrich\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_specialties\": [\n    {\n      \"value\": \"artificial intelligence\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_industries\": [\n    {\n      \"value\": \"Software Development\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Computer Hardware Manufacturing\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"past_company_names\": [\n    {\n      \"value\": \"Meta\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"past_company_domains\": [\n    {\n      \"value\": \"facebook.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_types\": [\n    {\n      \"value\": \"Public Company\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_headquarters\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"New York\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_headcounts\": [\n    {\n      \"min\": 50,\n      \"max\": 200,\n      \"exclude\": false\n    },\n    {\n      \"min\": 1000,\n      \"max\": 5000,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_founded_years\": [\n    {\n      \"min\": 2020,\n      \"max\": 2024,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_ids\": [\n    {\n      \"value\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ],\n  \"person_ids\": [\n    {\n      \"value\": \"746e4816-19c8-54d8-b558-65a5a52cc85c\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ],\n  \"person_names\": [\n    {\n      \"value\": \"John Smith\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"person_linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/in/john-doe\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"person_locations\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"California\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"person_skills\": [\n    {\n      \"value\": \"JavaScript\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Python\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Project Management\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_seniority_level\": [\n    {\n      \"value\": \"Director\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"VP\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_titles\": [\n    {\n      \"value\": \"Chief Technology Officer\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"VP of Engineering\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"past_position_titles\": [\n    {\n      \"value\": \"Software Engineer\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_years_in\": [\n    {\n      \"min\": 0,\n      \"max\": 1,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_years_at\": [\n    {\n      \"min\": 2,\n      \"max\": 5,\n      \"exclude\": false\n    }\n  ],\n  \"person_universities\": [\n    {\n      \"value\": \"Stanford University\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"MIT\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_days_since_last_job_change\": [\n    {\n      \"min\": 0,\n      \"max\": 90,\n      \"exclude\": false\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fullenrich.com/api/v2/people/search")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"offset\": 0,\n  \"limit\": 20,\n  \"current_company_names\": [\n    {\n      \"value\": \"Anthropic\",\n      \"exact_match\": true,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"OpenAI\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_domains\": [\n    {\n      \"value\": \"google.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/company/fullenrich\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_specialties\": [\n    {\n      \"value\": \"artificial intelligence\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_industries\": [\n    {\n      \"value\": \"Software Development\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Computer Hardware Manufacturing\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"past_company_names\": [\n    {\n      \"value\": \"Meta\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"past_company_domains\": [\n    {\n      \"value\": \"facebook.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_types\": [\n    {\n      \"value\": \"Public Company\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_headquarters\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"New York\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_headcounts\": [\n    {\n      \"min\": 50,\n      \"max\": 200,\n      \"exclude\": false\n    },\n    {\n      \"min\": 1000,\n      \"max\": 5000,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_founded_years\": [\n    {\n      \"min\": 2020,\n      \"max\": 2024,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_ids\": [\n    {\n      \"value\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ],\n  \"person_ids\": [\n    {\n      \"value\": \"746e4816-19c8-54d8-b558-65a5a52cc85c\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ],\n  \"person_names\": [\n    {\n      \"value\": \"John Smith\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"person_linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/in/john-doe\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"person_locations\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"California\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"person_skills\": [\n    {\n      \"value\": \"JavaScript\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Python\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Project Management\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_seniority_level\": [\n    {\n      \"value\": \"Director\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"VP\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_titles\": [\n    {\n      \"value\": \"Chief Technology Officer\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"VP of Engineering\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"past_position_titles\": [\n    {\n      \"value\": \"Software Engineer\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_position_years_in\": [\n    {\n      \"min\": 0,\n      \"max\": 1,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_years_at\": [\n    {\n      \"min\": 2,\n      \"max\": 5,\n      \"exclude\": false\n    }\n  ],\n  \"person_universities\": [\n    {\n      \"value\": \"Stanford University\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"MIT\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_days_since_last_job_change\": [\n    {\n      \"min\": 0,\n      \"max\": 90,\n      \"exclude\": false\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

200

Example

{
  "people": [
    {
      "id": "746e4816-19c8-54d8-b558-65a5a52cc85c",
      "full_name": "Enzo Romera",
      "first_name": "Enzo",
      "last_name": "Romera",
      "location": {
        "country": "France",
        "country_code": "FR",
        "city": "Paris",
        "region": "IDF"
      },
      "social_profiles": {
        "linkedin": {
          "url": "https://www.linkedin.com/in/john-doe",
          "handle": "john-doe",
          "connection_count": 500
        }
      },
      "educations": [
        {
          "school_name": "Stanford University",
          "degree": "Bachelor of Science in Computer Science",
          "start_at": "2015-09-01T00:00:00Z",
          "end_at": "2019-06-01T00:00:00Z"
        }
      ],
      "languages": [
        {
          "language": "French",
          "code": "FR",
          "proficiency": "Native or Bilingual"
        }
      ],
      "skills": [
        "JavaScript",
        "Project Management",
        "Python"
      ],
      "employment": {
        "current": {
          "title": "Senior Software Engineer",
          "company": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Anthropic",
            "domain": "anthropic.com",
            "description": "AI safety and research company",
            "year_founded": 2021,
            "headcount": 2610,
            "company_type": "Privately Held",
            "locations": {
              "headquarters": {
                "line1": "548 Market St",
                "line2": "PMB 42570",
                "city": "San Francisco",
                "region": "California",
                "country": "United States",
                "country_code": "US"
              },
              "offices": [
                {
                  "line1": "548 Market St",
                  "line2": "PMB 42570",
                  "city": "San Francisco",
                  "region": "California",
                  "country": "United States",
                  "country_code": "US"
                }
              ]
            },
            "industry": {
              "main_industry": "Software Development"
            },
            "social_profiles": {
              "linkedin": {
                "url": "https://www.linkedin.com/company/anthropic",
                "handle": "anthropic",
                "follower_count": 125000
              }
            }
          },
          "is_current": true,
          "start_at": "2022-03-15T00:00:00Z",
          "end_at": "2024-06-30T00:00:00Z"
        },
        "all": [
          {
            "title": "Senior Software Engineer",
            "company": {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "name": "Anthropic",
              "domain": "anthropic.com",
              "description": "AI safety and research company",
              "year_founded": 2021,
              "headcount": 2610,
              "company_type": "Privately Held",
              "locations": {
                "headquarters": {
                  "line1": "548 Market St",
                  "line2": "PMB 42570",
                  "city": "San Francisco",
                  "region": "California",
                  "country": "United States",
                  "country_code": "US"
                },
                "offices": [
                  {
                    "line1": "548 Market St",
                    "line2": "PMB 42570",
                    "city": "San Francisco",
                    "region": "California",
                    "country": "United States",
                    "country_code": "US"
                  }
                ]
              },
              "industry": {
                "main_industry": "Software Development"
              },
              "social_profiles": {
                "linkedin": {
                  "url": "https://www.linkedin.com/company/anthropic",
                  "handle": "anthropic",
                  "follower_count": 125000
                }
              }
            },
            "is_current": true,
            "start_at": "2022-03-15T00:00:00Z",
            "end_at": "2024-06-30T00:00:00Z"
          }
        ]
      }
    }
  ],
  "metadata": {
    "total": 20523,
    "offset": 0
  }
}

The People Search endpoint lets you build precise lists of individuals based on role, seniority, skills, location, company attributes, and career history. You can combine multiple filters to narrow down exactly the profiles you are looking for, whether you are targeting new hires, decision-makers, or specific personas.

If you already know exactly who you want to retrieve, you can also search for a specific person using their LinkedIn profile URL, which is the most reliable way to match a single individual.

For a full list of supported filters and accepted values (industries, company types, seniority levels, etc.)

Predefined Filter Values

For a full list of supported filters and accepted values (industries, company types, seniority levels, etc.)

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

offset · integer

Number of people to skip (use this for pagination)

Example:

0

limit · integer

Number of people to return (default: 10, max: 100)

Example:

20

current_company_names · object[]

Filter by current company names. Use exact_match for precise company name matching.

Show child attributes

Example:

[
  {
    "value": "Anthropic",
    "exact_match": true,
    "exclude": false
  },
  {
    "value": "OpenAI",
    "exact_match": true,
    "exclude": false
  }
]

current_company_domains · object[]

Filter by current company domains (e.g., 'google.com', 'microsoft.com'). Exact match recommended for domains.

Show child attributes

Example:

[
  {
    "value": "google.com",
    "exact_match": true,
    "exclude": false
  }
]

current_company_linkedin_urls · object[]

Filter by current company LinkedIn URLs.

Show child attributes

Example:

[
  {
    "value": "https://www.linkedin.com/company/fullenrich",
    "exact_match": true,
    "exclude": false
  }
]

current_company_specialties · object[]

Filter by current company specialties.

Show child attributes

Example:

[
  {
    "value": "artificial intelligence",
    "exact_match": true,
    "exclude": false
  }
]

current_company_industries · object[]

Filter by company industries (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Housing and Community Development', 'Warehousing')

Show child attributes

Example:

[
  {
    "value": "Software Development",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "Computer Hardware Manufacturing",
    "exact_match": false,
    "exclude": false
  }
]

past_company_names · object[]

Filter by past company names. Useful for finding people with specific work history.

Show child attributes

Example:

[
  {
    "value": "Meta",
    "exact_match": true,
    "exclude": false
  }
]

past_company_domains · object[]

Filter by past company domains

Show child attributes

Example:

[
  {
    "value": "facebook.com",
    "exact_match": true,
    "exclude": false
  }
]

current_company_types · object[]

Filter by company types (e.g., 'Public Company', 'Privately Held', 'Non-profit', 'Self-employed')

Show child attributes

Example:

[
  {
    "value": "Public Company",
    "exact_match": true,
    "exclude": false
  }
]

current_company_headquarters · object[]

Filter by company headquarters locations (city names, regions, or countries)

Show child attributes

Example:

[
  {
    "value": "San Francisco",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "New York",
    "exact_match": false,
    "exclude": false
  }
]

current_company_headcounts · object[]

Filter by company size (number of employees). Use ranges to target specific company sizes.

Show child attributes

Example:

[
  { "min": 50, "max": 200, "exclude": false },
  {
    "min": 1000,
    "max": 5000,
    "exclude": false
  }
]

current_company_founded_years · object[]

Filter by company founding year. Useful for targeting startups or established companies.

Show child attributes

Example:

[
  {
    "min": 2020,
    "max": 2024,
    "exclude": false
  }
]

current_company_ids · object[]

Filter by specific company IDs

Show child attributes

person_ids · object[]

Filter by specific person IDs

Show child attributes

person_names · object[]

Filter by person names (first name, last name, or full name)

Show child attributes

Example:

[
  {
    "value": "John Smith",
    "exact_match": false,
    "exclude": false
  }
]

person_linkedin_urls · object[]

Filter by person LinkedIn URLs.

Show child attributes

Example:

[
  {
    "value": "https://www.linkedin.com/in/john-doe",
    "exact_match": true,
    "exclude": false
  }
]

person_locations · object[]

Filter by person locations (city, region, or country)

Show child attributes

Example:

[
  {
    "value": "San Francisco",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "California",
    "exact_match": false,
    "exclude": false
  }
]

person_skills · object[]

Filter by skills (e.g., 'JavaScript', 'Python', 'Project Management')

Show child attributes

Example:

[
  {
    "value": "JavaScript",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "Python",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "Project Management",
    "exact_match": false,
    "exclude": false
  }
]

current_position_seniority_level · object[]

Filter by person seniority levels (e.g., 'Entry level', 'Mid-Senior level', 'Director', 'Executive', 'VP', 'C-level')

Show child attributes

Example:

[
  {
    "value": "Director",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "VP",
    "exact_match": false,
    "exclude": false
  }
]

current_position_titles · object[]

Filter by current job titles (e.g., 'Software Engineer', 'Product Manager', 'CEO')

Show child attributes

Example:

[
  {
    "value": "Chief Technology Officer",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "VP of Engineering",
    "exact_match": false,
    "exclude": false
  }
]

past_position_titles · object[]

Filter by past job titles. Useful for finding people who held specific roles.

Show child attributes

Example:

[
  {
    "value": "Software Engineer",
    "exact_match": false,
    "exclude": false
  }
]

current_position_years_in · object[]

Filter by years spent in current position. Useful for targeting people new in role or experienced.

Show child attributes

Example:

[{ "min": 0, "max": 1, "exclude": false }]

current_company_years_at · object[]

Filter by years at current company (tenure). Useful for targeting new hires or long-term employees.

Show child attributes

Example:

[{ "min": 2, "max": 5, "exclude": false }]

person_universities · object[]

Filter by universities attended (e.g., 'Stanford University', 'MIT', 'Harvard')

Show child attributes

Example:

[
  {
    "value": "Stanford University",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "MIT",
    "exact_match": false,
    "exclude": false
  }
]

current_company_days_since_last_job_change · object[]

Filter by days since last job change. Useful for finding people who recently changed jobs.

Show child attributes

Example:

[{ "min": 0, "max": 90, "exclude": false }]

Response

200

application/json

OK

people · object[]

Array of people matching the search criteria. Returns empty array if no results found.

Show child attributes

metadata · object

Show child attributes