Search for a person or find people by title | HumanConnection

const url = 'https://api.humanconnection.sh/api/v0/search_humans';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"name":"Brian Chesky","company_name":"Airbnb"}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

[
  {
    "name": "Brian Chesky",
    "profiles": {
      "linkedin_profile_url": "https://linkedin.com/in/brianchesky",
      "x_profile_url": "https://x.com/bchesky",
      "instagram_profile_url": "https://instagram.com/bchesky"
    },
    "confidence": 0.85,
    "email": "brian.chesky@airbnb.com",
    "company_domain": "airbnb.com",
    "bio": "@ Airbnb. I am one of the founders and CEO of Airbnb. San Francisco",
    "location": "San Francisco"
  }
]

Two modes:

Person lookup: Provide name to find a specific person’s social profiles, location, company domain, and optionally email.
People search: Provide location + title_filters to find professionals matching job title criteria (returns up to 10 results).

Two modes: 1. **Person lookup**: Provide `name` to find a specific person's social profiles, location, company domain, and optionally email. 2. **People search**: Provide `location` + `title_filters` to find professionals matching job title criteria (returns up to 10 results).

Request

This endpoint expects an object.

namestringOptional

Full name of the person (person lookup mode)

company_namestringOptional

Company name to disambiguate (e.g. ‘Airbnb’, ‘Stripe’)

company_domainstringOptional

Company domain if known (e.g. ‘airbnb.com’). Skips domain discovery.

locationstringOptional

City or region. Hint for person lookup, required for people search.

title_filtersstringOptional

Boolean job title filter using AND/OR/NOT syntax (people search mode)

provide_emailbooleanOptional

When true, finds the person's professional email via SMTP verification

Response

Array of matching humans

namestring

profilesobject

confidencedouble0-1

LinkedIn +0.40, X +0.25, Instagram +0.20, TikTok +0.15

emailstring

Professional email (when provide_email is true)

company_domainstring

Company website domain (e.g. ‘airbnb.com’)

biostring

Bio with company, role, and location

locationstring