AI Talent Match Pro
🏢 Acme Talent ▾
SL
API Reference · v20.0.0
🕐 Last updated: April 2026

AI Talent Match Pro
Developer API

Real-time, multi-dimensional candidate scoring powered by GPT-4o on Azure. Scored against your own team. Built for recruiting platforms.

200
Average latency
99.9%
Uptime SLA
GPT-4o
AI engine
Azure
Infrastructure
⬇ Download OpenAPI JSON ▶ Try the API
Try It

Runs a live GPT-4o candidate evaluation from your browser — real output from our scoring engine, no setup or key needed.

Live API Console
GET /api/demo/example
Authentication

All API requests require a function key passed as a query parameter. Contact api@aitmp.io for enterprise API access.

Enterprise Access: API keys are provisioned per organization with rate limiting, usage analytics, and dedicated support.
Authentication
https://api.aitmp.io/api/candidates/search?code=YOUR_API_KEY
Base URL
Production
https://api.aitmp.io
Search Candidates

Not implemented. Candidate sourcing would require an Apollo key, which is not configured — this endpoint returns an honest 501. To score candidates you already have — with Gold / Silver / Bronze tiers and reasoning — use POST /api/candidates/score.

200 / batch
Batch Scoring Proven via Azure Application Insights. Average p95 latency is 87ms.
POST /api/candidates/search Score candidates against a job description

Request Body

ParameterTypeRequiredDescription
job_description string Required The role and its requirements, as free text.

Example Request

cURL
JavaScript
Python
cURL
curl -X POST "https://api.aitmp.io/api/candidates/search?code=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_description": "Senior Backend Engineer — 6+ years Python or Go, Kafka, PostgreSQL, AWS. Payments experience a plus."
  }'
JavaScript
const response = await fetch("https://api.aitmp.io/api/candidates/search?code=YOUR_KEY", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    job_description: "Senior Backend Engineer — 6+ years Python or Go, Kafka, PostgreSQL, AWS."
  })
});
const data = await response.json();
console.log(data); // sourcing status (ok / configured / message)
Python
import requests

response = requests.post(
    "https://api.aitmp.io/api/candidates/search",
    params={"code": "YOUR_KEY"},
    json={
        "job_description": "Senior Backend Engineer — 6+ years Python or Go, Kafka, PostgreSQL, AWS."
    }
)
data = response.json()
print(data)

Example Response

JSON Response
{
  "ok": true,
  "configured": true,
  "error": "Candidate sourcing isn't connected — add APOLLO_API_KEY to enable it. To score candidates you already have, use POST /api/candidates/score."
}

If sourcing isn't connected yet, this returns an honest 501 — never fabricated people: { "ok": false, "configured": false, "error": "Candidate sourcing isn't connected yet…" }. To get scored candidates with Gold / Silver / Bronze tiers, adaptability, focus penalty and reasoning, send candidates you already have to POST /api/candidates/score.

Tier System

Every candidate is automatically ranked into one of three tiers:

🥇
95–100
The Perfect Soul
Exact title match, complete skill coverage, aligned trajectory.
🥈
85–94
The Mirror
Equivalent seniority and scope, minor gaps in nice-to-haves.
🥉
70–84
The Adjacent
One step removed, high trajectory velocity, worth a conversation.
Response Schema
match_score integer Overall fit score 0–100. Gold ≥95, Silver ≥85, Bronze ≥70.
adaptability integer How well the candidate transfers skills across roles. 100 = highly adaptable.
focus_penalty integer Career scatteredness penalty. 0 = highly focused. 100 = very scattered.
silent_skill string AI-identified psychological strength e.g. "Creates clarity in chaos".
ai_analysis string Natural language justification explaining the score and trajectory bonus.
latency_ms integer End-to-end API response time in milliseconds.
Health Check
GET /api/health Check API status and version
Response
{
  "status": "healthy",
  "service": "AI Talent Match Pro",
  "version": "20.0.0",
  "cold_start": false
}
Error Codes
StatusCodeDescription
200 success Request successful
400 invalid_request Missing or invalid parameters
401 unauthorized Invalid or missing API key
500 internal_error Server error — contact support
Rate Limits
PlanRequests/minCandidates/request
Free101
Business602
Corporate3003
EnterpriseUnlimited50
LinkedIn Integration

AI Talent Match Pro is designed to plug directly into LinkedIn Talent Solutions as a scoring layer.

LinkedIn Talent Solutions Partner: Actively applying for the LinkedIn Talent Solutions Partner Program. Contact partnerships@aitmp.io for integration discussions.
Integration Flow
// Your system sends a candidate → we score → return tier

1. LinkedIn Recruiter surfaces a candidate
2. POST /api/candidates/search with candidate + job description
3. Each CV is scored against your Team DNA
4. Gold / Silver / Bronze tier returned
5. LinkedIn displays tier badge on candidate card