v1

latestOpenAPI 3.1.02026-07-26103879.6 KB

Search people

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

post/people/search

Request body

offsetinteger

Number of people to skip (use this for pagination). Maximum value is 10,000. To paginate beyond 10,000 results, use search_after instead.

limitinteger

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

search_afterstring

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. The search_after token does not have any expiration date. However, when the database is updated (every month), if the position of a contact changes, the same search_after token might display different results.

Example request

{
  "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_professional_network_ids": [
    {
      "value": 1234,
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_professional_network_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",
      "exact_match": true
    }
  ],
  "person_ids": [
    {
      "value": "746e4816-19c8-54d8-b558-65a5a52cc85c",
      "exact_match": true
    }
  ],
  "person_names": [
    {
      "value": "John Smith",
      "exact_match": false,
      "exclude": false
    }
  ],
  "person_professional_network_ids": [
    {
      "value": 1234,
      "exact_match": true,
      "exclude": false
    }
  ],
  "person_professional_network_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_languages": [
    {
      "value": "English",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "French",
      "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_job_functions": [
    {
      "value": "Software Development",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_sub_functions": [
    {
      "value": "Freelancer",
      "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
    }
  ]
}

Response

Example response

{
  "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": {
        "professional_network": {
          "id": 1234,
          "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",
          "proficiency": "NATIVE_OR_BILINGUAL"
        }
      ],
      "skills": [
        "JavaScript",
        "Project Management",
        "Python"
      ],
      "employment": {
        "current": {
          "title": "Senior Software Engineer",
          "seniority": "Senior",
          "job_functions": [
            {
              "function": "Not Employed",
              "sub_function": "Freelancer"
            }
          ],
          "description": "Leading the backend team and designing microservices architecture.",
          "company": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Anthropic",
            "domain": "anthropic.com",
            "description": "AI safety and research company",
            "year_founded": 2021,
            "headcount": 2610,
            "headcount_range": "1001-5000",
            "company_type": "Privately Held",
            "specialties": [
              "Data Enrichment",
              "B2B Data"
            ],
            "locations": {
              "headquarters": {
                "line1": "548 Market St",
                "line2": "San Francisco, CA 94105, US",
                "city": "San Francisco",
                "region": "California",
                "country": "United States",
                "country_code": "US"
              },
              "offices": [
                {
                  "line1": "111 8th Ave",
                  "line2": "New York, NY 10011, US"
                }
              ]
            },
            "industry": {
              "main_industry": "Software Development"
            },
            "social_profiles": {
              "professional_network": {
                "id": 1234,
                "url": "https://www.linkedin.com/company/anthropic",
                "handle": "anthropic",
                "connection_count": 125000
              }
            }
          },
          "is_current": true,
          "start_at": "2022-03-15T00:00:00Z",
          "end_at": "2024-06-30T00:00:00Z"
        },
        "all": [
          {
            "title": "Senior Software Engineer",
            "seniority": "Senior",
            "job_functions": [
              {
                "function": "Not Employed",
                "sub_function": "Freelancer"
              }
            ],
            "description": "Leading the backend team and designing microservices architecture.",
            "company": {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "name": "Anthropic",
              "domain": "anthropic.com",
              "description": "AI safety and research company",
              "year_founded": 2021,
              "headcount": 2610,
              "headcount_range": "1001-5000",
              "company_type": "Privately Held",
              "specialties": [
                "Data Enrichment",
                "B2B Data"
              ],
              "locations": {
                "headquarters": {
                  "line1": "548 Market St",
                  "line2": "San Francisco, CA 94105, US",
                  "city": "San Francisco",
                  "region": "California",
                  "country": "United States",
                  "country_code": "US"
                },
                "offices": [
                  {
                    "line1": "111 8th Ave",
                    "line2": "New York, NY 10011, US"
                  }
                ]
              },
              "industry": {
                "main_industry": "Software Development"
              },
              "social_profiles": {
                "professional_network": {
                  "id": 1234,
                  "url": "https://www.linkedin.com/company/anthropic",
                  "handle": "anthropic",
                  "connection_count": 125000
                }
              }
            },
            "is_current": true,
            "start_at": "2022-03-15T00:00:00Z",
            "end_at": "2024-06-30T00:00:00Z"
          }
        ]
      }
    }
  ],
  "metadata": {
    "total": 20523,
    "credits": 22.5,
    "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0="
  }
}