Developers

BlitzApply API & SDK

BlitzApply is an AI agent that applies to jobs for you. Share a job URL and it reads the posting, picks (and optionally tailors) one of your resumes, applies via a cloud browser, then tracks the outcome from your inbox. This page shows how to drive all of that programmatically — over REST, the Python/TypeScript SDKs, or MCP so your own AI agent can run it.

Machine-readable index for agents: /llms.txt · SDKs & source: github.com/…/blitzapply-sdk

Authentication

Every request is authenticated with an API key (prefixed ba_). Create one in the dashboard under Settings → API Keys. The key acts on your account, and all usage (AI tokens + cloud-browser cost) is billed to you. Send it as the X-API-Key header. Never expose it in client-side code.

curl https://blitzapply.com/api/billing/summary \
  -H "X-API-Key: ba_xxxxxxxxxxxxxxxxxxxxxxxx"

Base URL: https://blitzapply.com

SDKs

Official clients live in the blitzapply-sdk repository (Python + TypeScript + MCP docs).

Python

pip install blitzapply

from blitzapply import BlitzApply
ba = BlitzApply(api_key="ba_...")

# Apply — the orchestrator picks the best enabled resume and tailors it.
app = ba.apply("https://boards.greenhouse.io/acme/jobs/123", tailor=True)
print(app["id"], app["status"])          # -> "queued"

for a in ba.list_applications():
    print(a["company"], a["status"], a["costUsd"])

print(ba.usage()["totalSpentUsd"])       # what you've spent

TypeScript / Node

npm install @blitzapply/sdk

import { BlitzApply } from "@blitzapply/sdk";
const ba = new BlitzApply({ apiKey: "ba_..." });

const app = await ba.apply("https://boards.greenhouse.io/acme/jobs/123", { tailor: true });
console.log(app.id, app.status);
console.log(await ba.usage());

MCP — connect your AI agent

BlitzApply runs a Model Context Protocol server so a Claude, Cursor, or any MCP-capable agent can apply to jobs and read outcomes on your behalf. Point your client at:

https://blitzapply.com/mcp

Authenticate with your API key (X-API-Key) or the built-in OAuth flow (the server publishes the standard /.well-known/oauth-* discovery routes).

Tool	Description
submit_job_application	Apply to a job by URL (optionally pick/tailor a resume). Returns application id + status.
list_applications	List your applications, newest first; filter by status.
get_application	Full detail for one application (status, live view, cost, outcome).
list_resumes	List your resumes and which are enabled for auto-apply.
get_usage	Usage cost summary (Gemini + Browser-Use) per source and action.
get_stats	Application stats: totals by status and outcome.
search_inbox	Search your connected inbox (e.g. find interview emails).
get_inbox_connect_url	Get the OAuth URL to connect an Outlook inbox.

REST API reference

All endpoints are under the base URL and require the X-API-Key header.

Method	Path	Description
POST	/api/applications	Start an application from a job URL (body: url, resumeId?, tailor?).
GET	/api/applications	List your applications.
GET	/api/applications/{id}	Get one application (status, cost, live view, outcome).
PATCH	/api/applications/{id}	Update an application (e.g. approve submit, cancel).
GET	/api/users/{uid}/resumes	List your resumes.
POST	/api/resume/extract	Extract structured resume data from an uploaded PDF/image.
POST	/api/agent/run	Run the AI resume orchestrator (tailor/optimize).
GET	/api/billing/summary	Your usage + cost summary (what you will be billed).
POST	/api/keys	Create an API key. GET to list, DELETE /api/keys/{id} to revoke.

Example — apply to a job

curl -X POST https://blitzapply.com/api/applications \
  -H "X-API-Key: ba_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://boards.greenhouse.io/acme/jobs/123","tailor":true}'

# -> { "id": "abc123", "status": "queued" }

Usage & billing

Every AI token and cloud-browser action is metered to your account. Check your running cost any time with GET /api/billing/summary (or get_usage over MCP). New accounts get a free starter credit; beyond that, usage is billed to your balance.

Questions or security reports: support@blitzapply.com (see also /.well-known/security.txt). Back to blitzapply.com.