people.get_analytics

Compare this window of networking against the one before it

Request

GET/api/v1/people/analytics

Scope required

contacts:read

Effect

Reads only. Safe to retry and safe for an agent to call unprompted.

Acts on

Acts on the account’s own job search.

MCP tool

people_get_analytics

Environment

Live and sandbox alike.

Request body

JSON.

What it does

Answers how much networking happened over the window and how that compares with the equal-length window immediately before it, plus the contacts talked to most. Every comparison is like for like: thirty days against the previous thirty, never a running total against a window. Each metric says in `comparison.kind` whether a percentage is even meaningful — the `all` range has no earlier window, and growth from an empty window has no percentage. Use `people.get_overview` for who to contact next.

Parameters

Response

generatedAt

string, required

interactionsByType

array of object, required

count

integer, required

type

one of: call, direct_message, email, follow_up, job_fair, meeting, networking_event, recruiter_outreach, reference_check, referral, social_media, thank_you_note, other, required

interactionVolume

array of object, required

countsByType

object, required

label

string, required

startsOn

string, required

total

integer, required

metrics

array of object, required

comparison

object or object or object, required

current

integer, required

name

one of: new_contacts, interactions, active_contacts, meetings, required

range

one of: 7d, 30d, 90d, 1y, all, required

topContacts

array of object, required

companyName

string or null, required

contactId

string, required

interactionCount

integer, required

name

string, required

Examples

curl -s https://www.jobapplicationtracking.com/api/v1/people/analytics?range=30d \
  -H "Authorization: Bearer $JAT_KEY"

{
  "range": "30d",
  "generatedAt": "2026-02-11T17:05:00.000Z",
  "metrics": [
    {
      "name": "interactions",
      "current": 11,
      "comparison": {
        "kind": "compared",
        "previous": 8,
        "changePercent": 38,
        "direction": "up"
      }
    }
  ],
  "topContacts": [
    {
      "contactId": "ct_42",
      "name": "Dana Okafor",
      "companyName": "Acme",
      "interactionCount": 4
    }
  ],
  "interactionVolume": [],
  "interactionsByType": [
    {
      "type": "email",
      "count": 11
    }
  ]
}

Related operations