USusehomie
Search

Intelligent network search

Search across the organization's combined network with a natural-language query, structured criteria, or both. Supports the same filters as MCP search_network.

post/api/v1/search/network

Request

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

Request body

querystring

People criteria from the user's goal and context, e.g. 'seed investors in Nordic B2B software' or 'senior product designers in Helsinki'. Preserve requested roles, industries and locations; do not add sales ICP criteria to non-sales searches. Optional when titles, industries, locations, companyLocations or companySizes are given.

titlesstring[]

Job titles to match, e.g. ['CRO', 'VP of Sales', 'Head of Sales Enablement']. Added to whatever the query names; widened with similar titles unless similarTitles is false.

industriesstring[]

Current-company industries (LinkedIn names such as 'Software Development', 'IT Services and IT Consulting'); widened with related ones unless similarIndustries is false.

locationsstring[]

Where the person is based: countries, states, regions or cities, e.g. ['United States', 'Canada'] or ['San Francisco Bay Area', 'New York'].

companyLocationsstring[]

Where the person's current company is headquartered.

companySizesstring[]

Company employee bands, e.g. ['201-500', '501-1000', '10001+']; several bands combine into one range.

similarTitlesboolean

Widen titles with similar ones (VP Sales also finds Vice President of Sales, Head of Revenue). Default: on at strictness 1. true widens at any strictness; false keeps the given titles only.

similarIndustriesboolean

Widen industries with related ones. Default true.

networksstring[]

Which networks to include (default: all three)

strictnessinteger

1=relaxed (default), 2=normal, 3=strict

asUserIdstring

Optional: org member whose perspective to use for user/advocate networks. Defaults to the authenticated MCP user when available, otherwise the oldest admin.

limitinteger
offsetinteger

Pass the previous response's nextOffset to get the next page; omit for the first page.

excludePersonIdsstring[]

Person ids never to return, e.g. everyone already shown to the user in this conversation.

excludeCompaniesstring[]

Leave out people currently at these companies (case-insensitive name match), e.g. existing customers or competitors.

excludeIndustriesstring[]

Leave out people whose current company is in these industries, e.g. an ICP's exclusions such as ['Manufacturing', 'Retail', 'Transportation, Logistics'].

excludePositionsstring[]

Title keywords to leave out, matched on word boundaries, e.g. ['account executive'] when the ICP rules out individual sellers.

directContacts'include' | 'exclude' | 'only'

People the searching user already knows directly. include (default) keeps them; exclude leaves them out so every result needs an introduction (prospecting); only returns just them ('who do I already know who fits').

excludeConnectorPersonIdsstring[]

Person ids no intro route may pass through, e.g. a connector the user ruled out. People reachable only through them are left out.

excludeConnectorNamesstring[]

No intro route may pass through a connector with this name (case-insensitive substring), e.g. ['Celeste Berke'], with no id lookup needed.

excludeConnectorCompaniesstring[]

No intro route may pass through a connector currently at these companies (case-insensitive name match).

mode'auto' | 'vector' | 'neo4j' | 'prisma'

Search backend. Leave unset to select automatically and allow fallback.

Response

Ranked search results

Changes

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