EasyTopJobs Public API

The public REST API served from apps/web — the same endpoints we offer to third parties and dogfood in our own web + desk clients. Build commit: dev.

OpenAPI: 3.1.0
Version: dev
Commit: dev

View the JSON spec

#Jobs

#`get/api/jobs/search`

Search the public job catalogue

Filters, counts, and facets the full catalogue in Postgres and returns one payload. Anonymous callers receive `total`, `addedToday`, and `facets` but an empty `previews` array. Signed-in free/paid callers receive up to 500 previews. The free tier is gated to 3 reveals/day (`remainingReveals`); a paid pass unlocks the fair-use window (`fairUseRemaining`).

name	in	required	type	description
q	query	no	string	Full-text query across job title, company, and description
location	query	no	string	Location filter
workplace	query	no	string	Workplace filter (e.g. remote / hybrid / onsite)
role	query	no	string	Role-class filter
seniority	query	no	string	Seniority filter
company	query	no	string	Company-name filter

200 Search results with access + gating metadata.

#Entitlements

#`get/api/entitlements`

The caller's current reveal + pass entitlements

Anonymous callers receive the default free allowance (freeRemaining 3, fairUseRemaining 80). Signed-in callers receive the free reveals left for today and their active paid-pass expiry (`paidUntil`), if any. Never errors — falls back to defaults when auth is unavailable.

200 Entitlement snapshot.

#Auth

#`post/api/auth/email`

Send a magic-link sign-in email

Sends a Supabase OTP link to the given email. Responds `{ ok: true, demo: true }` when auth is not configured, and `{ ok: true }` on success.

Request body (required): multipart/form-data

200 Link sent (or demo acknowledgement).
400 Invalid email or provider error.

#Billing

#`post/api/checkout`

Start a Stripe checkout for the 24h pass

Creates a Stripe Checkout session for the signed-in user and 303-redirects to it. Redirects back to the sign-in modal when unauthenticated, or to the credits modal when a pass is already active or Stripe is not configured (demo mode).

303 Redirect to Stripe Checkout or an on-site modal state.

#Jobs

#get/api/jobs/search