Public jobs API
Show GreenHired jobs in your app, filter by category, country, work mode and pay, and chart salary statistics. Read-only.
Read green jobs and salary data, manage your own account and your company's jobs, or connect an AI assistant. Two REST APIs and one MCP server, all JSON over HTTPS, all documented here.
Each one has its own key or sign-in, and its own limits. Start with the one that matches what you want to do.
Show GreenHired jobs in your app, filter by category, country, work mode and pay, and chart salary statistics. Read-only.
Make your own key. Seekers read their profile, applications and saved jobs. Employers read their company and create, publish and close jobs from their own systems.
Let Claude, ChatGPT or Cursor search green jobs and, if you allow it, work with your own account. Sign in with GreenHired; nothing to install.
Every call is an HTTPS request with a bearer key. This one checks that your key works and shows its permissions and limits.
curl -s https://api.greenhired.com/v1/ping \
-H "Authorization: Bearer $GREENHIRED_API_KEY" const res = await fetch('https://api.greenhired.com/v1/ping', {
headers: { Authorization: 'Bearer ' + process.env.GREENHIRED_API_KEY },
});
console.log(await res.json()); import os, requests
res = requests.get(
"https://api.greenhired.com/v1/ping",
headers={"Authorization": "Bearer " + os.environ["GREENHIRED_API_KEY"]},
timeout=15,
)
print(res.json()) Where most people go next.
Three services, each at its own address. All are version 1, which only grows: nothing is removed or renamed.
| Service | Address | How you get in | Status |
|---|---|---|---|
| Public jobs API | https://api.greenhired.com/v1 | An API key, issued on request by the GreenHired team | Live |
| Account API | https://api.greenhired.com/v1/assistant | A personal key you make yourself. Employers also need the company owner to allow job changes | Live |
| MCP server | https://mcp.greenhired.com/mcp | Sign in with GreenHired, or an API key for the job search tools | Live |
Last updated . Every page can be copied as Markdown, for your notes or for an AI assistant.
ghk_ key, which the GreenHired team issues on request. For your own account you make a ghpk_ personal key yourself. To connect an AI assistant you do not need a key: you sign in with GreenHired.