Get a Job Posting — это GET по /premium/v2/{account_id}/linkedin/jobs/{job_id}, часть семейства linkedin в API Premium от MakeHybrid. Каждый запрос несёт ваш собственный ключ в заголовке X-API-KEY; ключ решает, какая вы организация, а значит, какие аккаунты LinkedIn вы можете назвать.
Это семейство передаёт запрос на собственную поверхность LinkedIn, поэтому форму ответа задаёт LinkedIn, а не мы.
Запрос
curl -X GET "https://makehybrid.com/premium/v2/$ACCOUNT_ID/linkedin/jobs/$JOB_ID" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Что идёт в путь
- account_id — подключённый аккаунт LinkedIn, от имени которого действуем. Это должен быть аккаунт, подключённый вашим же ключом; на любой другой id ответ будет 404.
- job_id — id, который вернул предыдущий вызов из этого семейства.
Что приходит, когда не работает
- 401 — ключа нет, он неверный или отозван.
- 402 — тариф не оплачен. Premium отвечает так, когда пробный период закончился.
- 404 — либо этого нет, либо id аккаунта не ваш. Оба случая намеренно дают один и тот же ответ, чтобы id нельзя было перебрать.
- 429 — слишком много запросов или LinkedIn придерживает аккаунт. Помогает только ожидание; повторить раньше — значит продлить его.
- 503 — LinkedIn или переход перед ним не ответил. В теле — голый статус, который он увидел.
Любая ошибка — это JSON одной и той же формы: {"type":"errors/<code>","status":<n>,"detail":"..."} — поэтому один обработчик покрывает все, а detail написан так, чтобы его можно было показать человеку.
Попросить ассистента
Эта операция ещё и инструмент MCP. Вставьте https://makehybrid.com/mcp/<ваш ключ API> в Claude, ChatGPT или любого ассистента, говорящего на MCP, и попросите обычными словами — ассистент сам выберет вызов, подставит id и прочитает вам ответ. Устанавливать ничего не нужно.
В каком тарифе
Тариф Premium, на /premium. 9 $ за подключённый аккаунт LinkedIn в месяц, 7 $ от десяти аккаунтов и 5 $ от тысячи, с 30 днями пробного периода на один аккаунт.