API
Ship email verification
in an afternoon.
Fareof's REST API gives you programmatic access to the same email verification and lead search engine that powers our web app. Simple JSON, no XML config, no SOAP. SDKs for Python, Node.js, and Go. Ship your integration in hours, not weeks.
API endpoints
/api/verifyVerify a single email address. Returns deliverability status, confidence score, MX/SMTP checks, and catch-all detection.
curl "https://api.fareof.com/api/[email protected]" \
-H "Authorization: Bearer YOUR_API_KEY"/api/verify/bulkVerify up to 50,000 emails in a single request. Returns results as they complete or via webhook callback.
curl -X POST "https://api.fareof.com/api/verify/bulk" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"emails": ["[email protected]", "[email protected]"]}'/api/searchAI-powered lead search. Describe who you need in natural language or use structured filters for role, industry, company size, and more.
curl "https://api.fareof.com/api/search?q=Series-B+fintech+CFOs+in+NYC" \
-H "Authorization: Bearer YOUR_API_KEY"/api/enrich/linkedinEnrich a LinkedIn profile URL with verified email, phone, company info, and 50+ firmographic data points.
curl "https://api.fareof.com/api/enrich/linkedin?url=linkedin.com/in/alex" \
-H "Authorization: Bearer YOUR_API_KEY"Authentication
All API requests are authenticated with a Bearer token you generate from your dashboard. Keys are scoped to a single workspace and can be rotated or revoked instantly.
Authorization: Bearer YOUR_API_KEYRate limits
| Plan | Verifications / month | Rate limit | Concurrent requests | Webhooks |
|---|---|---|---|---|
| Free | 1,000 | 10 req/s | 2 | — |
| Pro | Unlimited | 50 req/s | 10 | Included |
| Enterprise | Unlimited | Custom | Custom | Included + SIEM |
SDKs & libraries
Native SDKs for Python, Node.js, and Go with typed responses and built-in retry logic. Community-maintained wrappers for Ruby, PHP, and Java available on GitHub.
Python
pip install fareof
Node.js
npm install @fareof/api
Go
go get github.com/fareof/api-go
Webhooks
Subscribe to events for async workflows. Webhooks fire on bulk verification completion, new lead enrichment, and list export ready. Payloads are signed with HMAC-SHA256 for verification. Retry with exponential backoff, up to 5 attempts.
Ready to integrate?
Full API reference with request/response schemas, error codes, and playground is in our docs.