ApplyTOP CLI

Install

Install the CLI globally with npm. It is plain JavaScript (ESM), needs Node ≥ 18, and is zero-config to get started.

npm install -g applytop

Or run it without installing, using npx:

npx applytop jobs:search -q engineer

Pro requirement

You need an API key to use the CLI. Keys are self-serve on your API Keys page and look like at_live_…. See the REST API docs for getting a key.

Authenticate

Log in once and your key is stored at ~/.applytop/credentials.json. auth:login prompts for your key, validates it, and saves it:

applytop auth:login                        # prompts for your key, validates it, saves it
applytop auth:login --api-key at_live_xxx
applytop auth:status                       # who am I?
applytop auth:logout

Or set an environment variable instead of logging in:

export APPLYTOP_API_KEY=at_live_xxx

Or pass --api-key per command.

Usage & global options

Commands are namespaced resource:action and print JSON to stdout, so they pipe cleanly into jq:

applytop jobs:search -q "react developer" --work-model remote --limit 5 | jq '.jobs[].title'
applytop account:me
applytop account:credits
applytop matches:list --min-score 60 --limit 10
applytop cvs:list
applytop cvs:tailor <jobId> --cv <cvId>        # costs 1 credit
applytop cvs:pdf <cvId> -o resume.pdf

Run applytop --help or applytop <command> --help for full details.

Global options

export APPLYTOP_API_URL=https://dev.applytop.com/api/v1
applytop --insecure account:me

Command reference

Every command and its options. Commands marked 1 credit spend one AI credit from the key owner's balance; everything else is free.

Auth

Account

Jobs

Alerts

Matches & Saved

CVs & AI tools

Examples

applytop jobs:search -q engineer --limit 5
applytop jobs:get --slug senior-react-engineer-abc123
applytop alerts:list --status active
applytop alerts:jobs alr_abc123 --min-score 70
applytop matches:list --min-score 60 --limit 10
applytop saved:list --work-model remote
applytop cvs:ats-score cv_abc123                 # 1 credit
applytop cvs:tailor job_abc123 --cv cv_abc123    # 1 credit
applytop cvs:cover-letter job_abc123 --hiring-manager "Alex Smith"   # 1 credit
applytop cvs:pdf cv_abc123 -o resume.pdf

Programmatic use

The same package exports a client class — use it directly from your own code:

import { ApplyTop, ApplyTopError } from 'applytop';

const client = new ApplyTop({ apiKey: process.env.APPLYTOP_API_KEY });

const { jobs, total } = await client.jobsSearch({ q: 'engineer', work_model: 'remote', limit: 5 });
console.log(total, jobs.map((j) => j.title));

try {
  const result = await client.cvsTailorToJob({ jobId, cvId });   // 1 credit
  console.log(result.cvId, 'balance:', result.balance);
} catch (err) {
  if (err instanceof ApplyTopError && err.code === 'insufficient_credits') {
    console.error(`Need ${err.required}, have ${err.balance}`);
  } else {
    throw err;
  }
}

Each method returns the response data:

me(), credits(), jobsSearch(), jobsGet(), alertsList(), alertsJobs(), matchesList(), matchesGet(), savedList(), cvsList(), cvsGet(), cvsAtsScore(), cvsTailorToJob(), cvsCoverLetterForJob(), and cvsDownloadPdf() (resolves to a Buffer).

Output & errors

Success prints the response payload as JSON to stdout (exit 0). Errors print { "error": { "code", "message" } } to stderr and exit 1.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough AI credits",
    "balance": 0,
    "required": 1,
    "tier": "free"
  }
}

Common error codes:

Credits

cvs:tailor, cvs:cover-letter, and cvs:ats-score each cost 1 AI credit (charged to the key owner; check with account:credits). Everything else is free.