apyhub
ARTIFICIAL INTELLIGENCE · HR

Career Trajectory and Loyalty API

What it does

Career Trajectory Analysis reads a resume timeline and returns a structured assessment of career movement and job loyalty. Send resumeContent, get back a summary that highlights gaps, pivots, trajectory, and a numeric loyaltyScore.

Use it when you need to screen resumes, compare candidate histories, or add a fast first-pass signal to an ATS workflow. The gaps array includes each period and an observation about what happened in that span, while pivots calls out notable changes in role, industry, or direction.

The trajectory field gives you a compact label for the overall path, such as stable, fast-moving, or entrepreneurial. loyaltyScore gives recruiters or hiring systems a simple integer they can sort or threshold on when reviewing applicants at scale.

Career Trajectory Analysis is a fit for HR teams, staffing platforms, and internal review tools that need a consistent way to summarise career history without parsing the timeline manually.

POST
Analyze a candidate’s career trajectory and loyalty
https://api.eu.apyverse.com/namastesumalya/analyze-career-trajectory

QUICKSTART

GUIDE

Quickstart

Send a resume summary to analyze career gaps, pivots, trajectory, and loyalty score.

curl -X POST "https://api.eu.apyverse.com/namastesumalya/analyze-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 gaps (an array of objects with period and observation), pivots (an array of strings), trajectory (a string), and loyaltyScore (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 career history provided in resumeContent and returns a JSON object describing career gaps, career pivots, an overall trajectory label, and a loyalty score.

Request Body

ParameterTypeMandatoryDescription
resumeContentStringNoCareer history and timeline details.

Response

Returns a JSON object with gaps, pivots, trajectory, and loyaltyScore fields. gaps is an array of objects, pivots is an array of strings, trajectory is a string, and loyaltyScore is an integer.

ParameterTypeMandatoryDescription
gapsObject ArrayNoCareer gap entries, if any. Each item contains period and observation fields.
gaps[].periodStringNoThe gap period, such as a date range.
gaps[].observationStringNoThe observation associated with the gap.
pivotsString ArrayNoCareer pivot descriptions.
trajectoryStringNoThe overall career trajectory label.
loyaltyScoreIntegerNoThe loyalty score.

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.