Skip to main content
POST
/
people
/
search
Search people
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,
  "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0=",
  "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
    }
  ]
}
'
{
  "people": [
    {
      "id": "746e4816-19c8-54d8-b558-65a5a52cc85c",
      "full_name": "Enzo Romera",
      "first_name": "Enzo",
      "last_name": "Romera",
      "location": {
        "country": "United States",
        "country_code": "US",
        "city": "San Francisco",
        "region": "California"
      },
      "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,
    "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0="
  }
}
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. Search API pricing 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). Maximum value is 10,000. To paginate beyond 10,000 results, use search_after instead.

Example:

0

​
limit
integer

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

Example:

20

​
search_after
string

Cursor-based pagination. Pass the search_after value from the previous response to get the next page. Works at any point in the result set, but is required to access results beyond the 10,000 offset limit.

Example:

"WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0="

​
current_company_names
object[]

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

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.

Example:
[
  {
    "value": "google.com",
    "exact_match": true,
    "exclude": false
  }
]
​
current_company_linkedin_urls
object[]

Filter by current company LinkedIn URLs.

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

Filter by current company specialties.

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')

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.

Example:
[
  {
    "value": "Meta",
    "exact_match": true,
    "exclude": false
  }
]
​
past_company_domains
object[]

Filter by past company domains

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')

Example:
[
  {
    "value": "Public Company",
    "exact_match": true,
    "exclude": false
  }
]
​
current_company_headquarters
object[]

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

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.

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.

Example:
[
  {
    "min": 2020,
    "max": 2024,
    "exclude": false
  }
]
​
current_company_ids
object[]

Filter by specific company IDs

​
person_ids
object[]

Filter by specific person IDs

​
person_names
object[]

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

Example:
[
  {
    "value": "John Smith",
    "exact_match": false,
    "exclude": false
  }
]
​
person_linkedin_urls
object[]

Filter by person LinkedIn URLs.

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)

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')

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')

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')

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.

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.

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.

Example:
[{ "min": 2, "max": 5, "exclude": false }]
​
person_universities
object[]

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

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.

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

Response

OK

​
people
object[]

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

​
metadata
object