Copyright Notice
© SupportFinity. All rights reserved.
This document and all content within it are protected and may not be copied, shared, or reproduced without written permission from SupportFinity.
Introduction
The SupportFinity Talent Signals API extracts deep AI-driven insights from a single input: the candidate’s CV.
Using SupportFinity’s proprietary multi-layer analysis engine, the API identifies meaningful talent attributes such as:
Leadership qualities
Educational background (including ranking and prestige)
Communication level
Technical capabilities
Behavioral patterns
Entrepreneurship exposure
Career progression
Cultural or environmental fit indicators
Overall strengths and risks
The engine also examines publicly available online presence signals, when found, to reinforce or validate extracted attributes.
This API is ideal for ATS systems, talent intelligence layers, internal mobility tools, and automated screening workflows.
1. Endpoint Information
Endpoint:
POST /ai/talent-signals
Description:
Generates SupportFinity Talent Signals by analyzing the candidate’s CV and, when available, public online presence indicators.
Version: 1.0
2. Authentication
Required: Yes
Type: Bearer Token
Header
Authorization: Bearer <token>
3. Request
HTTP Method
POST
Headers
Header | Type | Required | Description |
Authorization | string | Yes | Bearer token |
Content-Type | string | Yes | application/json |
Request Body
Schema
Field | Type | Required | Description |
candidateCV | string | Yes | Raw text of the candidate’s CV/resume |
Example Request
{
"candidateCV": "Senior engineer with leadership experience, founder of a small tech startup, graduate of a top national university..."
}4. Response
Success Response
Status: 200 OK
Content-Type: application/json
Schema
Field | Type | Description |
summary | string | Short description of the candidate’s profile |
signals | array | Extracted talent signals |
totalCount | number | Number of signals identified |
metadata | object | Optional metadata |
Example Response
{
"summary": "Strong candidate with leadership potential and solid academic background.",
"signals": [
"Leadership skills",
"Top national university",
"Entrepreneurship experience"
],
"totalCount": 3
}5. Error Responses
400 Bad Request
{
"status": 400,
"error": "Bad Request",
"message": "Candidate CV is missing or invalid."
}401 Unauthorized
{
"status": 401,
"error": "Unauthorized",
"message": "Authentication required."
}500 Internal Server Error
{
"status": 500,
"error": "Server Error",
"message": "An error occurred while generating talent signals."
}6. Usage Examples
cURL
curl -X POST https://api.supportfinity.com/ai/talent-signals \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "candidateCV": "..." }'
JavaScript (Fetch)
const response = await fetch("https://api.supportfinity.com/ai/talent-signals", {
method: "POST",
headers: {
Authorization: `Bearer ${accessToken}`,
"Content-Type": "application/json"
},
body: JSON.stringify({ candidateCV })
});Python (Requests)
response = requests.post(
"https://api.supportfinity.com/ai/talent-signals",
headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
json={"candidateCV": cv}
)
7. Notes
Uses proprietary SupportFinity logic to extract verified talent signals
May incorporate public online presence data, when available
CV quality directly influences the clarity and number of extracted signals
Output supports hiring decisions but does not replace human evaluation
8. Rate Limiting
Limit Type | Value |
Requests per minute | 60 |
Requests per hour | 500 |
Requests per day | 5000 |
9. Changelog
Version | Date | Changes |
2.3 | 2025-07-10 | Added improved academic ranking detection and enhanced leadership signal extraction. |
2.2 | 2025-01-28 | Added entrepreneurship confidence scoring and improved noise filtering for CV parsing. |
2.1 | 2025-01-15 | Introduced refined seniority estimation logic and improved online presence verification. |
2.0 | 2025-01-05 | Major update: new proprietary signal engine, faster extraction, clearer summaries. |
1.3 | 2025-01-02 | Added support for multilingual CVs with automatic language detection. |
1.2 | 2025-01-01 | Improved extraction accuracy for leadership and communication patterns. |
1.1 | 2024-12-30 | Added signal grouping for education, experience, and soft skills. |
1.0 | 2024-12-28 | Initial API release with core talent signal extraction. |