apyhub
ARTIFICIAL INTELLIGENCE · HR

Career Trajectory and Loyalty API

What it does

Candidate Career Analysis reviews a resume timeline and returns a structured read on career movement, gaps, and retention signals. Send resumeContent, and get back trajectory, loyaltyScore, pivots, and gaps.

Use it when you need a fast screening signal from a candidate profile. The gaps array includes each period and an observation explaining what the timeline suggests. The pivots list highlights notable role or industry changes, while trajectory summarises the overall path in a short label such as steady growth or entrepreneurial movement.

loyaltyScore gives you a simple integer you can use alongside the rest of your hiring workflow. That makes this service useful for recruiter dashboards, applicant triage, and internal review tools that need to compare career histories consistently without parsing resumes by hand.

Candidate Career Analysis is built for resume text only. Keep the input to the candidate’s career history and timeline details, and use the returned structure to support downstream ranking, review, or summarisation logic.

POST
Analyze a candidate’s career trajectory and loyalty
http://localhost:8080/namastesumalya/analyze-candidate-career-trajectory
QUICKSTARTGUIDE

Quickstart

Send a resume summary to analyze a candidate’s career trajectory.

curl -X POST "http://localhost:8080/namastesumalya/analyze-candidate-career-trajectory" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"resumeContent":"Career history and timeline details..."}'

What you'll get back

Returns a JSON object with these top-level fields:

  • gaps is an array of objects, each with:
    • period string
    • observation string
  • pivots is an array of strings
  • trajectory is a string
  • loyaltyScore is an integer
{
  "gaps": [
    {
      "period": "2018-2020",
      "observation": "Planned career sabbatical for travel."
    }
  ],
  "pivots": [
    "Transitioned from Corporate Big Tech to Startup Entrepreneurship in 2023"
  ],
  "trajectory": "Fast-track / Entrepreneurial",
  "loyaltyScore": 6
}
TRY ITLIVE · 500 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Analyzes the provided resume content to identify career gaps, career pivots, an overall trajectory classification, and a loyalty score. The request body contains the resume text; the response returns these analysis results in a JSON object.

Request Body

ParameterTypeMandatoryDescription
resumeContentStringYesResume or career history text to analyze.

Response

Returns a JSON object with four top-level fields: gaps as an array of objects, pivots as a string array, trajectory as a string, and loyaltyScore as an integer.

ParameterTypeMandatoryDescription
gapsObject ArrayNoCareer gap analysis entries. Each item contains period and observation.
gaps[].periodStringNoThe time range of the gap, if provided.
gaps[].observationStringNoThe observation associated with the gap, if provided.
pivotsString ArrayNoIdentified career pivot statements.
trajectoryStringNoOverall career trajectory classification.
loyaltyScoreIntegerNoLoyalty score returned by the analysis.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.