People Search API · For developers
The profile data API with the richest, freshest data in the industry
The people profile data API with the highest count of findable profiles: 1 billion across LinkedIn, GitHub and Stack Overflow, with the freshest real-time data.
Natural-language AI search
Pass a job description or free-text query and get intelligently matched results. No boolean strings needed.
1 billion profiles across channels
Fetch from 1 billion profiles across LinkedIn, GitHub and Stack Overflow with real-time fresh data. Uncover passive candidates beyond LinkedIn.
Screening & contact details
Add contextual AI screening and verified contact details. Get relevancy scores, candidate summaries, verified emails and phone numbers in every response.
One request. Enriched, ranked, contactable candidates.
Send a free-text query, choose your channels, and toggle AI screening and contact enrichment. The API does the sourcing, merging, scoring and verification for you.
Request
POST https://api.herohunt.ai/v1/search
Authorization: Bearer hh_live_••••••••••••••••
Content-Type: application/json
{
"query": "senior Python developer with open-source contributions in fintech",
"channels": ["linkedin", "github", "stackoverflow"],
"screening": true,
"contact_details": true
}Response
{
"results": [
{
"name": "Maria Alvarez",
"title": "Senior Backend Engineer",
"company": "Ledgerwise",
"location": "Berlin, Germany",
"match_score": 0.94,
"summary": "8 years building payment infrastructure in Python. Maintains two open-source fintech libraries and contributed to the Stripe SDK. Strong fit for fintech backend roles.",
"skills": ["Python", "FastAPI", "PostgreSQL", "Kafka", "Open Banking"],
"verified_email": "maria.alvarez@ledgerwise.io",
"verified_phone": "+49 30 1234 5678",
"channels": ["linkedin", "github", "stackoverflow"]
}
],
"total": 1,
"credits_used": 1
}What you get
Everything you need to turn a plain-text brief into a ready-to-contact shortlist, in a single API.
Natural-language search
Describe the role in plain English. The engine interprets intent and returns matched candidates.
1 billion profile reach
The largest multi-channel talent index available, spanning LinkedIn, GitHub and Stack Overflow.
AI screening & ranking
Relevancy scores plus qualification summaries that explain why each candidate fits.
Verified contact details
Professional emails and phone numbers, confirmed with SMTP verification before they reach you.
Real-time fresh data
Every request fetches live profile data. No stale caches weeks or months out of date.
Multi-channel profile merging
Combines LinkedIn, GitHub and Stack Overflow into one enriched, deduplicated profile.
Built for what teams do next
The People Search API plugs into the workflows recruiting and product teams already run.
Automate outreach
Pipe matched candidates and verified contact details straight into your sequencing tools and trigger personalized outreach at scale.
Find passive candidates
Reach engineers and specialists who never apply by searching GitHub and Stack Overflow alongside LinkedIn in a single call.
Recruit talent globally
Source across regions and channels with one query, building international shortlists without juggling separate databases.
Frequently asked questions
What is the People Search API?
HeroHunt.ai's core API product that gives developers and organizations programmatic access to our AI-powered talent search engine. It searches across 1 billion profiles on LinkedIn, GitHub and Stack Overflow simultaneously, returning enriched candidate data with AI screening scores and verified contact details.
How does the natural-language search work?
Instead of complex boolean strings or rigid filters, pass a full job description or a free-text query like 'senior Python developer with open-source contributions in fintech' and the AI interprets your intent and returns intelligently matched candidates.
What data does the API return?
Each profile includes professional information (title, company, experience, skills, education), an AI-generated relevancy score and qualification summary, and, when enrichment is enabled, verified professional email addresses and phone numbers.
How fresh is the data?
All data is fetched in real time. Unlike competitors that rely on cached databases weeks or months out of date, every request retrieves the freshest profile information available.
What about GDPR and compliance?
HeroHunt.ai only provides publicly available information and emphasizes compliance. The API is designed for professional outreach. Users are responsible for using contact data in line with anti-spam regulations and GDPR.
Fetch real-time profiles from 1B profiles today
Get programmatic access to the richest, freshest people search engine in the industry, with AI screening and verified contact details built in.