# Beta & coming soon

What is live today, labelled BETA and openly partial, and what is still being built. Nothing on this page is a promise of a ship date.

**What this covers:** What BETA means on this site.

**Assumed knowledge:** Nothing. This page is meant to be read on its own.

**Canonical HTML:** https://jobopportunitiesapi.org/docs/beta  
**Machine-readable index:** https://jobopportunitiesapi.org/docs/ai/index.md  
**Last verified:** 2026-09-28  
**Superseded by:** the live API at https://api.jobopportunitiesapi.org and its spec at https://jobopportunitiesapi.org/openapi.json — where this file and the API disagree, the API is right.

---

<a id="beta-roadmap"></a>

## 1. What BETA means on this site

A feature the product council explicitly deferred, now built anyway, with the honesty cost paid up front: every BETA surface says so in its own words, in the UI and in the API response, not just on this page.

### 1.1 In depth

Four items were named and deliberately deferred by the UX/journey councils that shaped this site (`~/reports/joa-ux/council-decision.md` section (f)) — each for a concrete, stated reason, never 'not important'. Those reasons are fixed one at a time; a feature moves off this page once it is no longer partial.

### 1.2 Exact contract

| Feature | Status | What it is |
| --- | --- | --- |
| **Hiring trends** | **BETA — partial data, live** | A daily snapshot of the existing Market Signals rollup and of company open-roles counts, so `/signals` and a company page can show a trend rather than only a point-in-time figure. History began the day the snapshot first ran — see [Market Signals history](./endpoints-public.md#public-market-signals-history). |
| Saved-search alerts | BETA — planned | Evaluating a saved search on a schedule and notifying when new rows match, built on cursor-based incremental evaluation rather than re-running the full filter. |
| Query playground | BETA — planned | An in-browser way to try filter combinations against the live API before writing any code. |
| Bulk export packs | BETA — planned | Pre-built, scheduled exports of common slices (a country, a job family) as a standing download rather than a one-off `/v1/export` call. |

> **Why partial data is shown at all, rather than waiting** — The alternative to shipping a short, honestly-labelled series is shipping nothing until a year of history exists — which means never shipping it, because the only way to have a year of history is to have started collecting it a year ago. Every BETA response says exactly how far back it goes; nothing here is presented as more complete than it is.

**See also**

- [Market Signals history — BETA](./endpoints-public.md#public-market-signals-history)
- [The complete list](./endpoints-public.md#public-endpoints-list)

---

## Where to go next

This file is part of **Start here**. Others in the same group:

- [Overview](./overview.md) — What the Job Opportunities API is, what it deliberately is not, and the ten minutes of reading that will save you the most time.
- [Quickstart](./quickstart.md) — From nothing to a real response in one command, and to an authenticated one in about a minute. No card at any point.
- [If you are a program](./for-agents.md) — This documentation has a plain-Markdown mirror with no JavaScript, no redirects and no browser required. Here is where it is and what is in it.
- [MCP server](./mcp.md) — A remote MCP server at api.jobopportunitiesapi.org/mcp — Streamable HTTP — so an AI agent in Claude, Cursor, Windsurf, VS Code or Cline can search live job postings with the same key, metering and plan limits as the REST API.
- [How to read this site](./conventions.md) — Three tiers on every concept, a copyable link on every section, and a rule about numbers that explains why almost nothing here is typed by hand.

Always useful:

- [index.md](./index.md) — the map of every file here
- [BUILD-A-SITE.md](./BUILD-A-SITE.md) — the paste-whole brief for building against this API
- [quickstart.md](./quickstart.md) — zero to a first authenticated response
- [api-errors.md](./api-errors.md) — every status code and whether to retry it