PeopleSearch.im

Search a global professional database in plain English (for example 'Heads of Marketing at Series B SaaS in New York') and get a sample of matching people plus the true total match count. Results are masked previews (a masked name, role, industry, company size and location) and each one carries an opaque `token`. Searching is FREE and spends no credits: use it to validate that the right people exist before you pay. If nothing matches exactly, the least essential filters are dropped automatically and `broadenedBy` names them. To get a person's real name, LinkedIn and verified email, pass their token to reveal_profile, or use find_people to unlock a batch in one call.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Who you are looking for, in plain English. Include role, seniority, industry, company stage/size, and location as needed."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "How many masked previews to return (1-25, default 10). This does not limit the reported total."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Unlock ONE person from a people_search result. Pass the `token` from that result. Spends 1 credit and returns the full profile: real name, current title and company, location and LinkedIn URL. Set `include_email` to true to also look up their verified professional (work) email in the same call, which spends 1 more credit that is refunded if no email is found. Revealing the same person again is free (idempotent). The email is looked up live and may take a moment: if it returns emailStatus 'searching', call reveal_profile again with the same token (no extra charge) to collect it.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "The opaque `token` of a person returned by people_search."
    },
    "include_email": {
      "type": "boolean",
      "description": "Also fetch the person's verified professional email (a second credit, refunded if none is found). Default false."
    }
  },
  "required": [
    "token"
  ],
  "additionalProperties": false
}

The list-building tool. Re-runs a plain-English people search exactly as people_search does (including its automatic broadening, reported in `broadenedBy`) and unlocks up to `count` full profiles in ONE atomic charge: 1 credit per newly unlocked person, and anyone you already own is free. Returns each person's real name, title, company, location, LinkedIn URL and an `id`. Emails are NOT fetched here (that is a separate credit): after unlocking, call fetch_email with each person's `id` to get their verified work email. WARNING for autonomous use: this can spend up to `count` credits in a single call, so choose `count` deliberately and confirm with the user before large batches. Returns an out-of-credits error instead of overspending.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Who you want, in plain English (same grammar as people_search)."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "How many people to unlock, 1-100 (default 25). Spends up to this many credits."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Look up the verified professional (work) email for a person you have already unlocked with find_people (or reveal_profile). Pass their `id`. Spends 1 credit, refunded automatically if no email is found. The lookup is live: if it returns emailStatus 'searching', call fetch_email again with the same id (no extra charge) to collect the result once it resolves. Returns a professional address, never a personal one; not every person has a findable work email.

{
  "type": "object",
  "properties": {
    "profile_id": {
      "type": "string",
      "description": "The `id` of a person returned by find_people (or reveal_profile)."
    }
  },
  "required": [
    "profile_id"
  ],
  "additionalProperties": false
}

Check whether an email address exists and is safe to send to, before it bounces. Returns a deliverability verdict (deliverable, undeliverable, or unknown) without sending anything. Spends 1 credit, refunded if no verdict can be reached.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to verify, e.g. [email protected]."
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}

Given a company domain or name, return the contactable role-based email addresses discovered for that organization (such as contact@, sales@, support@), each with a confidence level. Use this for reaching a company inbox, not a specific named person (for a named person use find_people or find_linkedin_profile). Spends 2 credits, refunded if none are found.

{
  "type": "object",
  "properties": {
    "domain_or_company": {
      "type": "string",
      "description": "A company domain (preferred, e.g. acme.com) or company name."
    }
  },
  "required": [
    "domain_or_company"
  ],
  "additionalProperties": false
}

Turn a professional email address into the real person behind it and their LinkedIn profile. Best for work emails; free-mailbox addresses often have no public profile to match. Spends 13 credits (this is the single most expensive lookup), refunded automatically if no match is found.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to identify, e.g. [email protected]."
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}

Find the LinkedIn profile URL for a named person. Provide their first and last name; adding the company or domain sharply improves the match. Spends 2 credits, refunded if no confident match is found.

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "description": "The person's first name."
    },
    "last_name": {
      "type": "string",
      "description": "The person's last name."
    },
    "company_or_domain": {
      "type": "string",
      "description": "Optional but recommended: the company name or domain they work at, to disambiguate common names."
    }
  },
  "required": [
    "first_name",
    "last_name"
  ],
  "additionalProperties": false
}

Turn a LinkedIn profile URL into clean structured data: name, current role and company, and location. Spends 2 credits, refunded if the profile cannot be retrieved.

{
  "type": "object",
  "properties": {
    "linkedin_url": {
      "type": "string",
      "description": "A LinkedIn profile URL, e.g. https://linkedin.com/in/…"
    }
  },
  "required": [
    "linkedin_url"
  ],
  "additionalProperties": false
}

Turn a LinkedIn company URL into firmographic data: industry, size, location and website. Spends 1 credit, refunded if the company cannot be retrieved.

{
  "type": "object",
  "properties": {
    "linkedin_company_url": {
      "type": "string",
      "description": "A LinkedIn company URL, e.g. https://linkedin.com/company/…"
    }
  },
  "required": [
    "linkedin_company_url"
  ],
  "additionalProperties": false
}

Search a global company database in plain English (for example 'Series B fintech companies in London with 50-200 employees') and get matching companies with industry, size, location and website. Searching companies is FREE and spends no credits.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The companies you want, in plain English."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Return the current credit balance for the API key making the request. Free and read-only. Use it before a large find_people call to confirm there are enough credits.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}