FAQ

What search engines does HumanConnection use?

HumanConnection uses SearXNG, a self-hosted meta-search engine. Under the hood, SearXNG queries Google, Bing, Brave, DuckDuckGo, and other engines. Each query is routed to a single engine (split-engine strategy) to reduce rate limiting.

How is email found?

When you set provide_email: true, HumanConnection discovers the company domain from SERP results (or uses the company_domain you provided), generates candidate email patterns (first@domain, first.last@domain, etc.), and verifies them via SMTP without sending any mail. This adds 2-5 seconds of latency.

Is HumanConnection free?

HumanConnection is open-source. You can self-host the full stack (SearXNG, Crawl4AI, API server) for free. The hosted API at api.humanconnection.sh requires an API key — see Getting an API Key for details.

What are the rate limits?

Rate limits depend on your plan. If you hit a limit, you’ll receive a 429 Too Many Requests response with a Retry-After header. The split-engine strategy helps reduce rate limiting at the search engine level.

How accurate is search_humans?

Accuracy depends on the person’s web presence and the context you provide. Well-known people with active LinkedIn profiles typically return confidence scores of 0.8+. Adding company_domain significantly improves accuracy for less well-known people. See Search Quality for tips.

What social platforms are searched?

search_humans searches for profiles on LinkedIn, X/Twitter, Instagram, and TikTok. It also crawls Linktree pages to discover non-obvious social handles.

Can I use HumanConnection without an AI agent?

Yes. You can call the REST API directly, use the CLI, or use the TypeScript toolkit in any Node.js application. The MCP integration is optional — it just makes it easier for AI agents to call the tools.

How does people search mode work?

Instead of searching for a specific person by name, you can provide location and title_filters to find professionals matching specific criteria. The title_filters parameter supports boolean syntax: "sales AND SaaS", "engineer OR developer NOT intern".

What event sources does search_events use?

search_events uses the Luma discover API to find conferences, meetups, and trade shows.

What place types does search_places support?

Restaurants, cafes, bars, golf courses, tennis/padel courts, galleries, museums, stadiums, gyms, and coworking spaces.

How does send_meeting_invite work?

It sends a Google Calendar invite to all specified attendee email addresses. The calendar invite is the booking — there’s no separate RSVP step.

What meeting outcomes can be reported?

send_meeting_report supports four outcomes: deal_closed, follow_up_needed, not_interested, and no_show.