People Enrichment API

Endpoint

GET /people/enrich

Description

This endpoint enriches person data with contact information (email, phone numbers) and social information based on the provided parameters. It uses rate limiting to prevent abuse.

Rate Limit

10 requests per 5 seconds per IP address

Query Parameters

You must provide either:

fullName with either companyName or companyUrl, OR
At least one of email, linkedInHandle, or twitterHandle

Try to provide as much data as you can on the individual you want to enrich. The more data we have, the better we will be able to find the right information for you.

Parameter	Type	Required	Description
fullName	string	*	Full name of the person
companyName	string	*	Name of the company the person works for
companyUrl	string	*	URL of the company (will be normalized)
email	string	*	Email address of the person
linkedInHandle	string	*	LinkedIn profile handle of the person
twitterHandle	string	*	Twitter profile handle of the person
enrichPhone	boolean	No	Whether to enrich the result with phone number (default: false)

* See requirement note above

Response

Success Response

Code: 200 OK
Content: JSON object containing enriched person data

Error Responses

Code: 400 Bad Request
- Content: { "error": "Invalid input", "details": [...] }
- Description: Returned when the input parameters are invalid or don't meet the requirements