GET /health
Service health and version
Ответы
200— Current version and source counters
Read-only access to the openradar feed: job vacancies and freelance orders merged from boards, RSS and Telegram. Free, no key. Guests see the feed with a delay and without contact details; that is the same projection the web site shows. Attribution when you republish: openradar.fun (CC BY 4.0 for research data).
Ключ не нужен. Гости видят ленту с задержкой и без контактов — та же проекция, что на сайте. Машиночитаемая схема: /openapi.json; каталог RFC 9727: /.well-known/api-catalog; MCP: /mcp.
curl "https://openradar.fun/api/leads?q=python&type=gig&limit=5"
curl "https://openradar.fun/api/market?title=python%20backend&type=job"
curl "https://openradar.fun/v2/feed?limit=20"
GET /healthService health and version
200 — Current version and source countersGET /api/leadsSearch the lead feed
The same filters the web feed uses. `sort=score` and `sort=budget` look at the last 7 days only.
| Имя | Где | Обязательность | Тип | Описание |
|---|---|---|---|---|
q | query | опциональный | string | Full-text search over title and text |
type | query | опциональный | enum: job | gig | job = employment, gig = an order |
skill | query | опциональный | string | Dictionary skill, exact match |
budget | query | опциональный | number | Minimum budget in roubles; converted to USD internally |
language | query | опциональный | enum: ru | en | Title language |
remote | query | опциональный | enum: 1 | Remote only |
workplace | query | опциональный | enum: remote | hybrid | onsite | Workplace arrangement: remote, hybrid, or onsite |
direction | query | опциональный | string | Role or trade direction, e.g. "backend", "frontend", "qa", "devops", "design" |
it | query | опциональный | enum: 1 | IT and adjacent trades only |
sort | query | опциональный | enum: new | score | budget | relevance | |
limit | query | опциональный | integer, min 1, max 500, default 50 | |
page | query | опциональный | integer, min 1 |
200 — Leads, newest first by default401 — GET /api/leads/{id}One lead card
| Имя | Где | Обязательность | Тип | Описание |
|---|---|---|---|---|
id | path | обязательный | string |
200 — The lead404 — Not found, or not yet visible to your tierGET /api/marketMarket pay estimate
Percentiles of pay for similar priced leads over the last 90 days, over what a guest may already see.
| Имя | Где | Обязательность | Тип | Описание |
|---|---|---|---|---|
title | query | обязательный | string | What the client needs, e.g. "лендинг на Tilda" |
type | query | опциональный | enum: job | gig | job = employment, gig = an order |
skills | query | опциональный | string | Comma-separated skills, up to 12 |
200 — Estimate with the basis used400 — title shorter than 3 charactersGET /api/insightsAggregate market insights (trending skills, directions, workplace share, pay percentiles, AI exposure)
Computed over the guest-visible feed for the requested window (default 30 days).
| Имя | Где | Обязательность | Тип | Описание |
|---|---|---|---|---|
type | query | опциональный | enum: job | gig | job = employment, gig = an order |
days | query | опциональный | integer, min 1, max 90, default 30 | Lookback window in days |
200 — Aggregate market statisticsGET /api/companies/suggestSuggest hiring employers by name prefix
| Имя | Где | Обязательность | Тип | Описание |
|---|---|---|---|---|
q | query | опциональный | string | Company name substring or prefix |
limit | query | опциональный | integer, min 1, max 50, default 10 |
200 — Matching employers with active vacancy counts and page URLsGET /api/deltaChanges since a moment, for synchronising tools
| Имя | Где | Обязательность | Тип | Описание |
|---|---|---|---|---|
since | query | опциональный | string, date-time | |
limit | query | опциональный | integer, max 1000, default 200 | |
format | query | опциональный | enum: json | ndjson |
200 — Lead changesGET /research/report.jsonFull empirical labour market research report & econometrics (JSON)
Live 30-day empirical study (CC BY 4.0): salary medians, 95% CIs, role x seniority heatmap (gradeMatrix), programming language x seniority heatmap (languageMatrix), regional econometrics & remote work premium (regionalComparison, regionalMatrix, byCity), Gini index, decile ratios, Bowley/Kelley skewness, employer HHI (econometrics), Mincerian log-wage OLS regression with White HC1 robust SEs, ANOVA variance decomposition, and non-parametric hypothesis tests (scientific).
200 — Complete research report objectGET /research/dataset.csvAnonymized micro-dataset of vacancies and freelance orders (CSV, CC BY 4.0)
19 standardized columns per deduplicated post: id, date, type, platform, role, grade, language, region, remote, company, pay_min_rub, pay_max_rub, pay_rub, pay_period, currency, pay_origin, ai_mention, skills, scope.
200 — CSV datasetGET /research/index.jsonDaily Russian-language and International (Global & Remote) market activity index (JSON)
7-day moving average index (base 100) across fixed reference panels for Russian-language and Global remote vacancies and freelance orders.
200 — Openradar daily panel indexGET /research/index.csvDaily market activity index time series (CSV)
200 — CSV time seriesGET /v2/feedradar/2 feed with cursor pagination
Cursor walks forward in time with `sort=new` (the default). Sends `x-radar-delay-minutes` and `x-radar-cursor` headers.
| Имя | Где | Обязательность | Тип | Описание |
|---|---|---|---|---|
cursor | query | опциональный | string | From x-radar-cursor of the previous page |
limit | query | опциональный | integer, max 200, default 50 | |
q | query | опциональный | string | Full-text search over title and text |
type | query | опциональный | enum: job | gig | job = employment, gig = an order |
workplace | query | опциональный | enum: remote | hybrid | onsite | Workplace arrangement: remote, hybrid, or onsite |
direction | query | опциональный | string | Role or trade direction |
occupation_code_or | query | опциональный | string | Comma-separated ILO ISCO-08 occupation unit group codes or prefixes (e.g. 2512,2513,2166) |
200 — Feed page and cursor401 — GET /v2/streamServer-sent events stream of new leads
SSE; event `lead`, the payload is the lead projection. Guests receive leads after their tier delay.
200 — text/event-streamPOST /mcpModel Context Protocol server
Streamable HTTP MCP with tools search_leads, get_lead_details, estimate_compensation, submit_lead, vote_lead, get_market_analytics, save_search, list_saved_searches, xray_generate_dorks. Keyless guest access; a signed participant key raises the tier.
Тело запроса: JSON-RPC 2.0 request (initialize, tools/list, tools/call).
200 — JSON-RPC over MCP; see https://modelcontextprotocol.ioA merged vacancy or order. Fields the viewer may not see (contacts for guests, pipeline internals) are absent.
| Поле | Тип | Описание |
|---|---|---|
id | string | |
type | string (job | gig) | |
title | string | |
score | integer | Static quality estimate; median ~60, 80+ is a strong lead |
verdict | string (strong | stretch | skip) | Explainable fit verdict from the score and binary gates; a failed gate always means skip |
gates | array | Hard binary filters applied before the verdict (live, single offer) |
checks | array | Named, human-readable checks explaining the score (score, pay, requirements, direction, detail) |
text | string | Up to 20 000 characters, contacts included for signed-in viewers |
url | string, uri | |
canonicalUrl | string, uri | |
author | string | |
city | string | |
budget | number | |
currency | string | ISO 4217-ish: RUB, USD, EUR, GBP, PLN, KZT, BYN, UAH, CHF, CAD, AUD |
paymentPeriod | string | fixed, monthly or hourly |
rawSalary | string | The pay as written in the post |
normalizedUsdMin | number | |
normalizedUsdMax | number | |
category | string | |
skills | array | |
isRemote | boolean | |
workplaceType | string (remote | hybrid | onsite) | Workplace arrangement: remote, hybrid, or onsite |
direction | string | Standardized trade direction, e.g. "backend", "frontend", "qa", "design" |
publishedAt | string, date-time | |
createdAt | string, date-time | |
votes_up | integer | |
votes_down | integer | |
votes_scam | integer | |
votes_closed | integer | |
contacts | array | Only for viewers whose tier shows contacts |
sourceRef | object | Where the post was seen: platform, channel, visibility |