Find & Hire Public API
REST endpoints for the Recruitment ROI engine
Authentication
Bearer tokens
Every request is authenticated with a personal API token tied to your account email. Tokens are issued from the API tab of your dashboard and rotate on demand.
Authorization: Bearer hrn_live_xxxxxxxxxxxxxxxx
Endpoint
POST /api/v1/calculate
Compute Resource Intake (RI), Time per Candidate (TPC), Success Velocity (SV) and the 18-state vacancy diagnostic for any vacancy snapshot.
Request body
{
"email": string, // owner's account email
"vacancyName": string, // human label
"tf": number, // Time to Fill (working days, 0–365)
"a": number, // Accepted candidates (0–500)
"o": number, // Offers extended (0–50)
"salary": number // Monthly salary cap (0–1,000,000)
}cURL
curl -X POST https://findhire.lovable.app/api/v1/calculate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"email": "you@company.com",
"vacancyName": "Senior Backend Engineer",
"tf": 42,
"a": 8,
"o": 1,
"salary": 12000
}'200 OK
{
"metrics": {
"RI": 50.0,
"TPC": 5.25,
"SV": 9.52,
"DL": 1636.36,
"TotalLoss": 48109.09,
"status": { "key": "saturated", "title": "Saturated Pipeline", "emoji": "🔥", "tone": "warning" }
},
"tokensRemaining": 4,
"plan": "free"
} Rate limits
- Free tier: 5 calls / day · shared with in-app calculations.
- $4.99 pack: +50 calls.
- Annual ($49): unlimited (fair-use throttled at 60 req/min).
- All responses include
X-RateLimit-Remaining.