# GreenHired API overview

> GreenHired has two REST APIs: a read-only jobs API for apps and partners, and an account API for job seekers and employers to use their own data and jobs.

- Source: https://greenhired.com/developers/api/v1/
- Section: GreenHired developers · API · Start here
- Last updated: 2026-11-21

## Two APIs, one version

GreenHired offers two REST APIs, both JSON over HTTPS and both at version 1. The **public jobs API** lets your app read green jobs, the 28 job categories and salary statistics. The **account API** lets a job seeker or an employer work with their own GreenHired account from their own scripts and systems.

|  | Public jobs API | Account API |
| --- | --- | --- |
| Base URL | `https://api.greenhired.com/v1` | `https://api.greenhired.com/v1/assistant` |
| For | Apps, researchers and partners that show or analyse green jobs | One job seeker or one employer, working with their own account |
| What it does | Reads jobs, job detail, categories and salary statistics | Seekers read their profile, applications and saved jobs. Employers read their company and manage its jobs |
| Credential | An API key that starts with `ghk_` | A personal key that starts with `ghpk_` |
| How you get it | On request, from the GreenHired team | You make it yourself on your account page |
| Writes data | Never. Every call is a `GET` | Only what you allow: your profile and saved jobs (seekers), your company's jobs (employers) |

Both send the key as `Authorization: Bearer <key>`. Neither is meant to be called from a web page, because that would put your key in front of every visitor. New here? Start with the [quickstart](https://greenhired.com/developers/api/v1/quickstart/).

## Which one do you need?

| You want to | Use | Start with |
| --- | --- | --- |
| Show GreenHired jobs in your app or on your site | Public jobs API | [List jobs](https://greenhired.com/developers/api/v1/jobs/) |
| Chart pay by category or country | Public jobs API | [Salary statistics](https://greenhired.com/developers/api/v1/salaries/) |
| Keep your own tracker in step with your applications and saved jobs | Account API, job seeker | [Job seeker API](https://greenhired.com/developers/api/v1/seekers/) |
| Sync your careers site or ATS with the jobs on GreenHired | Account API, employer | [Manage jobs](https://greenhired.com/developers/api/v1/employer-jobs/) |
| Let an AI assistant search jobs or act for a person | MCP server | [MCP overview](https://greenhired.com/developers/mcp/) |

## What is the same in both

- **One host.** Every GreenHired API is at `api.greenhired.com`. Addresses under `greenhired.com/api/` belong to the website's own pages: they are not an API we offer, support or document, and they can change at any time.
- Every answer is JSON. Times are ISO 8601 in UTC.
- A key is shown once, when it is made. We keep only a fingerprint, so a lost key cannot be recovered: make a new one.
- Each key has a per-minute limit and a daily cap. See [Rate limits](https://greenhired.com/developers/api/v1/limits/).
- Errors have a stable `code` you can program against. See [Errors](https://greenhired.com/developers/api/v1/errors/). The two APIs word the error body a little differently.
- Version 1 only grows: new endpoints and fields can appear, nothing is removed or renamed. See [Versioning](https://greenhired.com/developers/api/v1/versioning/).

> **Info:** The public API serves jobs that were posted on GreenHired itself. Jobs that GreenHired collects from partner feeds are not served until each source is cleared. See [Attribution and source terms](https://greenhired.com/developers/api/v1/attribution/).

## Frequently asked questions

**Is there a free-text search?**

Not in version 1. `GET /v1/jobs` filters by category, country, work mode, employment type, seniority, company, posting date and pay. A request with a `q` parameter is refused with a clear `unknown_parameter` error rather than ignored.

**Can I call the API from a browser?**

Do not. Keep the key on your server and send visitors your own pages or your own endpoint. Anything in browser code can be read by every visitor.

**Does the public API ever change data?**

No. It is read-only, and every endpoint is a `GET`. Changing data is only possible with the account API, with a personal key you made yourself.

**Where is the machine-readable description?**

The public API publishes an OpenAPI 3.1 file at `https://api.greenhired.com/v1/openapi.json`. It needs no key. See [OpenAPI and tool lists](https://greenhired.com/developers/api/v1/openapi/).

## Related pages

- https://greenhired.com/developers/api/v1/quickstart/
- https://greenhired.com/developers/api/v1/authentication/
- https://greenhired.com/developers/mcp/
