API Reference
Complete reference documentation for the LeadsCaptain API.
API Overview
Base URL
https://api.leadscaptain.com/v1 Authentication
All API requests require authentication using an API key in the header:
Authorization: Bearer YOUR_API_KEY Response Format
All responses are returned in JSON format with the following structure:
{
"status": "success",
"data": { },
"meta": { }
} Endpoints
People
/people List enriched people profiles with metadata (name, company, contact, socials).
View details →Companies
Leads
/leads/enrich Submit partial lead info (email, domain, LinkedIn) and enrich with full profile.
View details →Rate Limits
Our API implements rate limiting to ensure stability and fair usage:
- 200 requests per minute per API key
- 5000 requests per hour per API key
- 50,000 requests per day per API key
Rate limit information is included in the response headers:
X-RateLimit-Limit: 200 X-RateLimit-Remaining: 180 X-RateLimit-Reset: 1725097600
Error Handling
The API uses conventional HTTP response codes to indicate the success or failure of an API request:
- 2xx
Success response indicating the request was processed successfully
- 4xx
Client error response indicating an issue with the request
- 5xx
Server error response indicating an issue on our end
Error Response Format:
{
"status": "error",
"error": {
"code": "invalid_request",
"message": "The request was invalid",
"details": { }
}
}