Every endpoint, every filter.

Keyless product-evaluation sample capped at ten open jobs. It has no cursor and omits production-only descriptions, lifecycle feeds, and company exports.

Hybrid keyword search over the corpus. All filters combine with AND.

The title grammar

title accepts an OR of AND groups with negation — precedence ! then & then |, no parentheses. Each term is a case-insensitive substring.

# senior or staff, engineer, not manager
title=senior & engineer & !manager | staff & engineer & !manager

# URL-encoded in practice:
curl "https://jobs-api-stage.up.railway.app/v1/jobs/search?title=senior%20%26%20engineer%20%26%20!manager&limit=5" \
  -H "X-API-Key: $PRAXY_JOBS_KEY"

Typed JSON search for boolean keyword trees, facets, or an opt-in semantic query for current Growth and Scale accounts. Semantic mode searches open jobs, caps results at 100, and does not accept facets or cursor pagination. Keyword cursors remain bound to the original request and fail closed on filter drift.

Subscription-backed bulk export in CSV, NDJSON, or Parquet. CSV and NDJSON use bounded numbered parts; Parquet is returned as one spooled artifact. Description columns require a plan that explicitly includes them.

One job by stable key for an active subscription-backed X-API-Key. The payload includes full description_text. Supports include_unresolved.

The verified company directory. Filters: source, country, min_open_jobs, plus limit/cursor. With export=jsonl (key required) it streams the full catalog as newline-delimited JSON instead of paging.

Company profile: validated boards (platforms), hiring velocity, office network, department rollups, work-mode distribution, and open positions — every derived field labeled with its source and confidence.

All jobs at one company. status open (default) · closed · all, plus limit/cursor.

Public corpus statistics: totals, per-source and per-country counts, career-family coverage, enrichment coverage, freshness percentiles, and optional per-source description, posting-date, and salary fill rates with refresh cadence and last-sweep time. The same measured values our own pages render — unavailable fields stay unavailable rather than being inferred from global totals.

Paid, measured comparison of a company's first-observed openings across equal current and prior windows. The response includes the underlying weekly series and evidence boundary; it is a source-observation count, not a demand forecast.

Paid posting-duration proxy from first observation to definitive source closure, filterable by source, country, career family, or company. It does not claim a confirmed hire, and sparse samples return an explicit insufficient-data result instead of a guessed estimate.

Public quarterly report of first-observed posting volume and audited duration signals by ATS, country, and career family. Current quarters are labelled partial and never projected forward.

The latest retained, measured data-quality artifact. It is served only when a complete worker-produced report is available; missing computation is never replaced with inferred quality claims.

Newly indexed jobs by time window, oldest-first with keyset cursors — poll at window cadence and you never see the same job twice.

A credit-free count for the active-feed filters. Use it to size a pull before requesting job records.

Jobs that closed in the window, with closed_at and a close reason (removed_from_board · board_dead · expired_by_source). Params: time_frame, limit, cursor.

Field-level changes in the window — which fields changed, plus the updated job. Params: time_frame, limit, cursor.

Durable, sequence-ordered upsert and tombstone events. Persist next_seq only after processing the page, then pass it back as since_seq to resume after an arbitrarily long consumer gap.

Scale-only index of verified, immutable active-corpus snapshots. Dataset access is a flat plan entitlement and does not consume per-job API credits.

One dated snapshot manifest with short-lived signed Parquet part URLs, columns, row counts, and a single explicit expiry time.

List the authenticated Scale account's outbound Postgres and webhook destinations. Secret connection settings are never returned.

Create a disabled outbound destination. Enabling is a separate explicit operation, and each account has a bounded destination count.

Read one redacted destination configuration and its delivery state.

Update destination metadata or replace its stored secret configuration. Mutations fail with a retryable conflict while delivery is in progress.

Soft-delete an idle destination. A successful deletion returns no body.

Enable delivery and clear the destination's consecutive-failure count.

Pause future delivery without deleting destination metadata or run history.

Recent delivery runs with bounded, redacted reports and explicit source and destination acknowledgement counts.

Create a hosted subscription checkout. Body: {"email": "…", "plan": "growth", "return_url": "https://praxyjobs.com/checkout/return"}. Returns a Dodo-hosted checkout URL. Access stays pending until the signed subscription webhook has activated the account.

Signed billing-provider callback used to activate and update subscriptions. Duplicate event IDs are idempotent; unsigned payloads are rejected.

Exchange the single-use checkout claim token for an activated API key after the subscription webhook completes. Responses are never cached.

Create a hosted billing-portal session for the authenticated paid account.

Compatibility-only credential issuance retained for older clients. Body: {"email": "…"}. While paid enforcement is active, this credential does not unlock production REST endpoints; evaluate with /v1/jobs/preview and /v1/stats, then subscribe for production access.

Current plan, billing-period allowance, aggregate consumption, daily usage, and recent authenticated activity for the paid account behind the key.

List non-secret metadata for every key in the current paid account, including labels, four-character hints, status, and last use. Raw key material is never returned by this endpoint.

Create another account key with an optional label. The raw key is returned exactly once and shares the subscription's allowance with sibling keys.

Stage a replacement key without revoking the current one. Test the replacement, then revoke the old key explicitly.

Revoke an account-owned key. The last active key cannot be revoked, preventing accidental account lockout.

Per-day request and returned-job usage for your own account over up to 90 days. Requires an approved service key. Params: date_from, date_to.

Deterministic sitemap feed: 256 job-key segments with counts and last-modified stamps. This is what builds our own sitemap.

Active deduplicated job keys and honest last-modified timestamps for one deterministic sitemap segment.