openradar public API

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 /api/leads

Search the lead feed

The same filters the web feed uses. `sort=score` and `sort=budget` look at the last 7 days only.

Параметры

ИмяГдеОбязательностьТипОписание
qqueryопциональныйstringFull-text search over title and text
typequeryопциональныйenum: job | gigjob = employment, gig = an order
skillqueryопциональныйstringDictionary skill, exact match
budgetqueryопциональныйnumberMinimum budget in roubles; converted to USD internally
languagequeryопциональныйenum: ru | enTitle language
remotequeryопциональныйenum: 1Remote only
workplacequeryопциональныйenum: remote | hybrid | onsiteWorkplace arrangement: remote, hybrid, or onsite
directionqueryопциональныйstringRole or trade direction, e.g. "backend", "frontend", "qa", "devops", "design"
itqueryопциональныйenum: 1IT and adjacent trades only
sortqueryопциональныйenum: new | score | budget | relevance
limitqueryопциональныйinteger, min 1, max 500, default 50
pagequeryопциональныйinteger, min 1

Ответы

  • 200 — Leads, newest first by default
  • 401 —

Открыть на сайте

GET /api/leads/{id}

One lead card

Параметры

ИмяГдеОбязательностьТипОписание
idpathобязательныйstring

Ответы

  • 200 — The lead
  • 404 — Not found, or not yet visible to your tier

Открыть на сайте

GET /api/market

Market pay estimate

Percentiles of pay for similar priced leads over the last 90 days, over what a guest may already see.

Параметры

ИмяГдеОбязательностьТипОписание
titlequeryобязательныйstringWhat the client needs, e.g. "лендинг на Tilda"
typequeryопциональныйenum: job | gigjob = employment, gig = an order
skillsqueryопциональныйstringComma-separated skills, up to 12

Ответы

  • 200 — Estimate with the basis used
  • 400 — title shorter than 3 characters

Открыть на сайте

GET /api/insights

Aggregate market insights (trending skills, directions, workplace share, pay percentiles, AI exposure)

Computed over the guest-visible feed for the requested window (default 30 days).

Параметры

ИмяГдеОбязательностьТипОписание
typequeryопциональныйenum: job | gigjob = employment, gig = an order
daysqueryопциональныйinteger, min 1, max 90, default 30Lookback window in days

Ответы

  • 200 — Aggregate market statistics

Открыть на сайте

GET /api/companies/suggest

Suggest hiring employers by name prefix

Параметры

ИмяГдеОбязательностьТипОписание
qqueryопциональныйstringCompany name substring or prefix
limitqueryопциональныйinteger, min 1, max 50, default 10

Ответы

  • 200 — Matching employers with active vacancy counts and page URLs

Открыть на сайте

GET /api/delta

Changes since a moment, for synchronising tools

Параметры

ИмяГдеОбязательностьТипОписание
sincequeryопциональныйstring, date-time
limitqueryопциональныйinteger, max 1000, default 200
formatqueryопциональныйenum: json | ndjson

Ответы

  • 200 — Lead changes

Открыть на сайте

GET /research/report.json

Full 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 object

Открыть на сайте

GET /research/dataset.csv

Anonymized 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 dataset

Открыть на сайте

GET /research/index.json

Daily 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 index

Открыть на сайте

GET /v2/feed

radar/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.

Параметры

ИмяГдеОбязательностьТипОписание
cursorqueryопциональныйstringFrom x-radar-cursor of the previous page
limitqueryопциональныйinteger, max 200, default 50
qqueryопциональныйstringFull-text search over title and text
typequeryопциональныйenum: job | gigjob = employment, gig = an order
workplacequeryопциональныйenum: remote | hybrid | onsiteWorkplace arrangement: remote, hybrid, or onsite
directionqueryопциональныйstringRole or trade direction
occupation_code_orqueryопциональныйstringComma-separated ILO ISCO-08 occupation unit group codes or prefixes (e.g. 2512,2513,2166)

Ответы

  • 200 — Feed page and cursor
  • 401 —

Открыть на сайте

GET /v2/stream

Server-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-stream

Открыть на сайте

POST /mcp

Model 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.io

Открыть на сайте

Схема Lead

A merged vacancy or order. Fields the viewer may not see (contacts for guests, pipeline internals) are absent.

ПолеТипОписание
idstring
typestring (job | gig)
titlestring
scoreintegerStatic quality estimate; median ~60, 80+ is a strong lead
verdictstring (strong | stretch | skip)Explainable fit verdict from the score and binary gates; a failed gate always means skip
gatesarrayHard binary filters applied before the verdict (live, single offer)
checksarrayNamed, human-readable checks explaining the score (score, pay, requirements, direction, detail)
textstringUp to 20 000 characters, contacts included for signed-in viewers
urlstring, uri
canonicalUrlstring, uri
authorstring
citystring
budgetnumber
currencystringISO 4217-ish: RUB, USD, EUR, GBP, PLN, KZT, BYN, UAH, CHF, CAD, AUD
paymentPeriodstringfixed, monthly or hourly
rawSalarystringThe pay as written in the post
normalizedUsdMinnumber
normalizedUsdMaxnumber
categorystring
skillsarray
isRemoteboolean
workplaceTypestring (remote | hybrid | onsite)Workplace arrangement: remote, hybrid, or onsite
directionstringStandardized trade direction, e.g. "backend", "frontend", "qa", "design"
publishedAtstring, date-time
createdAtstring, date-time
votes_upinteger
votes_downinteger
votes_scaminteger
votes_closedinteger
contactsarrayOnly for viewers whose tier shows contacts
sourceRefobjectWhere the post was seen: platform, channel, visibility