Как выгрузить вакансии и зарплатные вилки из Greenhouse API: разбор подводных камней

Greenhouse — система, через которую компании публикуют вакансии. Побочный эффект: любая доска отдаётся наружу обычным JSON, без ключа, без регистрации и без постраничной выдачи. Доска SpaceX целиком — 2 832 вакансии — приезжает одним ответом. Замеры, о которых речь ниже, делались 27 октября 2026 года, между запросами пара секунд.

Это удобно, если нужен свой агрегатор, аналитика по рынку или просто список открытых позиций в компании, куда хочется попасть. И это же место, где легко получить мусор вместо данных: половина полей появляется только по флагу, а часть цифр означает не то, что кажется. Ниже — что выяснилось на живых досках.

Адрес один, токен — не название компании

Базовая ручка выглядит так:

curl -s "https://boards-api.greenhouse.io/v1/boards/spacex/jobs"

Подставляете токен доски — получаете список. Ошибка новичка в том, что токен кажется производным от имени. Проверка трёх вариантов подряд дала 404 для anduril, 200 для andurilindustries и 200 для xai. То есть у Anduril доска называется andurilindustries, а anduril не существует вовсе.

Разница между кодами ответа тут принципиальная. 404 — доски с таким токеном нет. 200 с пустым списком — доска есть, но сейчас ничего не открыто. Если код не проверять, оба случая сливаются в «данных не пришло», и вы будете чинить рабочий запрос вместо опечатки в токене.

Вилки зарплат спрятаны за флагом

В обычном ответе поля с зарплатой нет вообще. Добавляете ?pay_transparency=true — и у каждой вакансии появляется pay_input_ranges, в том же ответе. У Anduril вилка нашлась у 2 342 позиций из 2 520. Первая в списке: 9 000 000–11 000 000 центов, валюта USD, подпись «US Salary Range». В долларах это 90–110 тысяч, но пересчитывать центы придётся самому.

Две вещи, которые ломают наивный парсер. Первая: диапазонов у вакансии может быть несколько — например, отдельный «Zone 2 Pay Range» для другой географии. Вторая: подпись не гарантирует период. Среди диапазонов с заголовком «HOURLY POSITION» верхняя граница была 60 000, и из ответа не следует, за какой отрезок времени эта сумма. Валюту, период и тип ставки придётся нормализовать вручную, иначе сравнение вакансий превращается в случайные числа.

По 60 крупнейшим доскам Greenhouse вилки публикуют 32 компании, и ranges нашлись у 14 208 позиций из 53 750. SpaceX в этом поле не публикует ничего, зато у 1 518 из 2 832 вакансий строка «Pay Range» вписана в текст описания. Хотите зарплаты по этой компании — доставайте их регуляркой из HTML, а не из структурированного поля.

content=true: в двенадцать раз больше байт и двойное экранирование

Описание, отделы и офисы приходят только с ?content=true. Доска SpaceX без флага весит 2,7 МБ, с флагом — 32 МБ. Разница в двенадцать раз по объёму, и это на одну компанию.

Дальше начинается весёлое: HTML приезжает экранированным, вместо <p> в ответе лежит &lt;p&gt;. Сначала снимаете экранирование, потом вырезаете теги. В обратном порядке стриппер не находит ни одного тега и в текст уезжает <p> — ошибка выглядит глупо, а встречается почти в каждом самописном скрапере. И держите в голове вес: 32 МБ по расписанию — это память, таймауты и трафик.

Постинг и вакансия — разные единицы счёта

У каждого объявления свой id, а internal_job_id показывает, какая вакансия за ним стоит. У SpaceX 2 832 постинга раскладываются в 2 125 уникальных вакансий: одну позицию в Хоторне рекламируют под 13 разными заголовками. У Anduril 2 520 постингов — это 1 527 вакансий, и одна из них висит 14 раз: 7 заголовков, 5 локаций.

Отсюда простое правило. Считаете открытые позиции — группируйте по internal_job_id. Показываете список объявлений — берите id. Если перепутать, в отчёте «сколько компания нанимает» будет завышение в разы, а в интерфейсе — пачки почти одинаковых строк.

location — одна строка, offices — список

У Anduril в location.name может лежать до девяти городов через точку с запятой: так оформлены 196 постингов из 2 520. Разбирать это сплитом по «; » можно, но есть offices — там места лежат отдельными элементами со своими кодами вроде «Costa Mesa, CA (OC-00)».

Ещё есть metadata с полями конкретной компании. «Employment Type» у Anduril — «Full-time», у SpaceX — «Regular», рядом у SpaceX лежит «Discipline». Одинаковых значений у полей с одинаковым смыслом не ждите, нормализовать придётся руками.

Сводка по флагам, если нужен быстрый чек-лист перед запуском:

Когда этот способ не подходит

API закрывает только компании на Greenhouse. У Workday, Oracle и остальных ATS свои публичные ручки, и общий подход тот же — запрос к доске без ключа, только поля и флаги другие. Если возиться с каждой системой отдельно не хочется, есть готовые обвязки: Greenhouse Jobs Scraper на Apify принимает токен доски или домен компании, сам запрашивает pay_input_ranges, переводит центы в salaryMin и salaryMax с периодом и снимает экранирование с описания. Второй скрапер там же берёт работодателей по имени, включая компании на Workday и Oracle. Набор проверенных запросов к разным ATS лежит в открытом репозитории job-board-apis.

Если же нужна аналитика по одной компании, дешевле написать двадцать строк на shell и jq, чем подключать внешний сервис.

Главное, что стоит унести: доска Greenhouse — это бесплатный и полный срез вакансий компании, но счёт в нём двойной. Постинги считаются по id, реальные позиции — по internal_job_id, зарплаты появляются только по флагу и приходят в центах без указания периода. Проверка кода ответа, порядок «снять экранирование, потом резать теги» и группировка по внутреннему id — три вещи, без которых данные выглядят правдоподобно и врут.