canonical: https://jentic.com/apis/talentapi.com/talentapi
# Talent API · API Reference
API Support: support@radix.ai | Website: https://www.radix.ai
Job and profile matching using Artificial Intelligence.
What is it?
Talent API is a system that allows retrieving jobs recommendations for a profile or profiles recommendations for a job.
There are three types of entities involved:
<. The API exposes 25 endpoints secured with bearer authentication.
## For AI agents
Programmatically authenticate with the talent API., recommend profiles for a given job.. Covers 25 operations with bearer authentication.
## Scope
Does not handle payments, communications, or crm - use for hr and recruiting only.
## Capabilities
- Authenticate with the Talent API.
- Recommend profiles for a given job.
- Integrate Talent API · API Reference into automated workflows
- Query and filter Talent API · API Reference records by parameters
- Monitor Talent API · API Reference operational status and events
## Use cases
### HR and Recruiting Operations
Use the Talent API · API Reference to perform hr recruiting operations programmatically. The API provides 25 endpoints covering core functionality including authenticate with the talent API., recommend profiles for a given job., recommend jobs for a given profile..
Example prompt: Call POST /auth to authenticate with the talent API.
### Automated Recommend Management
Automate recommend operations by combining multiple Talent API · API Reference endpoints. Agents can recommend profiles for a given job. and then recommend jobs for a given profile. in a single workflow.
Example prompt: Call POST `/recommend/job/{job_id}/profiles` to recommend profiles for a given job., then verify the result
### AI Agent Integration via Jentic
AI agents discover and call Talent API · API Reference endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle bearer tokens manually.
Example prompt: Search Jentic for 'authenticate with the talent API.', load the operation schema, and execute with Jentic-managed credentials
## Key endpoints
| Method | Path | Description |
| --- | --- | --- |
| POST | `/auth` | Authenticate with the Talent API. |
| POST | `/recommend/job/{job_id}/profiles` | Recommend profiles for a given job. |
| POST | `/recommend/profile/{profile_id}/jobs` | Recommend jobs for a given profile. |
| POST | `/recommend-master/profile/{profile_id}/jobs` | Recommend jobs for a given profile (master). |
| POST | `/recommend-master/job/{job_id}/profiles` | Recommend profiles for a given job (master). |
| POST | `/recommend-master/job/{job_id}/jobs` | Recommend jobs for a given job (master). |
| POST | `/recommend-master/profile/{profile_id}/profiles` | Recommend profiles for a given profile (master). |
| POST | `/recommend/job/{job_id}/jobs` | Recommend job for a given job. |
## Key resources
- **Recommend** — Recommend jobs and profiles.
- **Search** — Search through uploaded jobs and profiles.
- **Add or Update** — Add or update job and profile data.
- **Delete** — Delete a job or profile.
- **Fetch** — Fetch a job or profile.
## AI readiness
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
- **Score:** 48 / 100
- **Maturity:** Foundational
- **Dimensions:**
- Foundational Compliance: 48 / 100
- Developer Experience & Jentic Compatibility: 59 / 100
- AI-Readiness & Agent Experience: 26 / 100
- Agent Usability: 94 / 100
- Security: 60 / 100
- AI Discoverability: 100 / 100
- **View full report:** https://jentic.com/apis/talentapi.com/talentapi/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview
### Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md
```sh
npx @jentic/api-scorecard-cli score
```
## Why Jentic
- **Setup:** Wiring the Talent API by hand means calling its auth endpoint for a JWT bearer token, sending it on every request, and threading job and profile ids through nested recommendation routes yourself. Through Jentic you install once, import the Talent API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** The Talent API puts the job id and profile id in the URL path (`/recommend/job/{job_id}/profiles`), so a rule can pin your agent to one job or profile: it can fetch recommendations for that record and nothing else. You choose the operations it may call, so the broader recommend-master routes are not included unless you add them.
- **Credential handling:** Your Talent API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'recommend profiles for a job' or 'recommend jobs for a profile', and Jentic returns the matching Talent API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
## Related APIs
- **Greenhouse** — Alternative hr recruiting API
- **Lever** — Alternative hr recruiting API
- **Workday** — Complementary hr recruiting API
## FAQ
### What authentication does the Talent API · API Reference use?
The Talent API · API Reference uses a Bearer token in the Authorization header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.
### Can I authenticate with the talent API. with the Talent API · API Reference?
Yes. Use the POST /auth endpoint. The API returns structured JSON responses that agents can parse and act on directly.
### What are the rate limits for the Talent API · API Reference?
Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.
### How do I authenticate with the talent API. through Jentic?
Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'authenticate with the talent API.'. Jentic returns the matching Talent API · API Reference operation with its input schema. Load the schema and execute the call - credentials are injected automatically.
### How many endpoints does the Talent API · API Reference have?
The Talent API · API Reference exposes 25 endpoints covering recommend, search, add or update operations.
### Can I limit what my agent is allowed to do with the Talent API?
Yes. Because you run Jentic One yourself, your own rules decide which Talent API operations and credentials the agent may use. Since the Talent API carries the job id and profile id in the URL path, such as `/recommend/job/{job_id}/profiles`, you can pin the agent to a single job or profile so it fetches recommendations for that record and nothing else. You also choose the exact operations it can call, so the broader recommend-master routes stay off limits unless you explicitly add them.