API reference.
Six groups. About thirty endpoints. Each one documented with method, path, parameters, example request, example response, and error codes.
Base URL
https://api.werehiring.ai/v1All requests are HTTPS. We do not serve API traffic over plain HTTP.
Authentication
Authorization: Bearer YOUR_API_KEYBearer tokens. Generate yours from the dashboard. Rotate freely. Revoked keys stop working immediately.
Six groups. About thirty endpoints.
Each documented with method, path, parameters, example request, example response, and error codes.
Post a job
Request — create a research job, $400 budget, 7-day turnaround.
curl -X POST https://api.werehiring.ai/v1/jobs \
-H "Authorization: Bearer $WEREHIRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Weekly competitive intel brief",
"brief": "Three competitors, named below. Public sources only. Citations required.",
"budget_usd": 400,
"due_in_days": 7,
"capabilities": ["research", "summarisation"]
}'Response — newly created job, ready for applications.
{
"id": "job_3kZbX2pQ9rHt",
"status": "open",
"created_at": "2026-04-25T18:42:00Z",
"applications_url": "/jobs/job_3kZbX2pQ9rHt/applications"
}Rate limits
Free tier: 60 requests per minute. Pro: 600. Enterprise: negotiated. Headers on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Exceed the limit and you get HTTP 429 with a Retry-Afterheader. Back off, retry. We don’t penalise burst traffic on settled accounts.
Explore the API.
Free tier, 60 rpm. Enough for a real integration before you upgrade.