Person Discovery API
Describe who you're looking for in plain English. AI-powered search across 184M+ professional profiles.
Just Describe Who You Need
POST /person/discover
Content-Type: application/json
API-Key: YOUR_API_KEY
{
"query": "VP of Engineering at Series B+ fintech companies in San Francisco",
"limit": 5
}{
"matches": [
{
"person": {
"legion_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"full_name": "david kim",
"job_title": "vp of engineering",
"company_name": "fintech solutions inc",
"company_size": "201-500",
"seniority_level": "vp",
"linkedin_url": "https://www.linkedin.com/in/davidkim",
"city": "san francisco",
"state": "california",
"emails": [...],
"phones": [...]
}
}
],
"total": 1
}Search with Natural Language
Skip the query building. Describe what you need and let AI handle the rest.
Natural Language Queries
Describe who you're looking for in plain English. No query syntax to learn.
AI-Powered Matching
AI interprets your intent and identifies the right filters automatically.
No SQL Required
No SQL knowledge required. Just describe what you need and get results.
Smart Intent Recognition
The API understands complex descriptions and maps them to precise filters.
Built for Speed and Simplicity
The Discovery API is designed for teams that need fast, flexible people search.
Quick Research
Quickly find people matching a description without writing queries.
- Find people by description
- No query building needed
- Instant results
Sales Prospecting
Describe your ideal customer profile in plain English and get matching contacts.
- Describe your ideal prospect
- AI handles the filtering
- Export matching profiles
Talent Discovery
Find candidates by describing the role and qualifications you need.
- Natural language candidate search
- Skill and experience matching
- Quick sourcing
Market Analysis
Run ad-hoc research queries to understand market segments and talent pools.
- Exploratory research
- Market landscape queries
- Competitive analysis
Discovery API vs Other Options
Choose the access method that fits your use case. Same data, different delivery.
Enrichment API Beta
Match and append data to your records
- 9 matching methods
- Confidence scores
- Per-record enrichment
Search API Beta
Query profiles on demand via API
- Flexible SQL queries
- Up to 100 results
- No infrastructure needed
Discovery API Beta
Natural language people search
- Natural language queries
- AI-powered matching
- No SQL required
- 50 requests per minute
Data License
Bulk file delivery for full dataset access
- Full dataset access
- Monthly refreshes
- Your infrastructure
Common Questions
What users of our Discovery API ask us most