USusehomie
Search

Search warm intro paths

Find warm intro paths from anyone in the organization to one target person or company. Pass prospectPersonId, prospectLinkedinId, prospectLinkedinUrl, prospectName (optionally with prospectCompany), prospectCompany, or prospectCompanyDomain. Domains match exact website hosts; ambiguous matches return 400. In company mode, people the organization has already requested an intro to are excluded by default and counted in excludedIntroRequested; pass includeIntroRequested=true to include them. Person mode never filters, but annotates the prospect.

get/api/v1/search/warm-paths

Request

  • Base URL
    https://app.usehomie.com
  • Auth
    HTTP bearer

Query parameters

prospectPersonIdstring
maxHopsinteger
includePossiblePaths'true' | 'false'
prospectLinkedinIdstring
prospectLinkedinUrlstring

LinkedIn /in/ profile URL. Mutually exclusive with other target parameters.

prospectNamestring
prospectCompanystring
prospectCompanyDomainstring

Company domain or HTTP(S) website URL. Exact normalized host match; preserves subdomains other than www.

prospectRolesstring

Company searches only. Comma-separated job-title terms; OR-matched before candidate limits. Also accepts repeated parameters.

limitinteger
offsetinteger nullable
includeIntroRequested'true' | 'false'

Company mode only. Default false.

scope'organization' | 'me'

Whose networks to search from. Default organization. 'me' requires a user-scoped token.

fromUserIdsstring

Comma-separated org member ids (user ids or person ids) to search from. Mutually exclusive with a non-default scope.

connectionTypesstring

Comma-separated path types to keep: direct, second_degree, third_degree, advocate, advocate_second_degree.

Response

Ranked list of warm paths to the prospect or company employees

Changes

No recorded changes to this operation across all 1 revision of this API.