API reference · Public jobs API

Job categories

GET /v1/categories lists the 28 green job categories with slug, name, sector, description and the number of live jobs in each. Use the slugs as a filter.

1 min read Updated Maintained by the GreenHired team
View Markdown
On this page
  1. The request
  2. What you get
  3. The 28 slugs
  4. Frequently asked questions

#The request

GET /v1/categories returns the 28 green categories GreenHired uses to group jobs. Use a category's slug as the category filter of List jobs. The endpoint takes no parameters.

GET/v1/categoriesapi.greenhired.comcategories:read

The 28 green categories.

curl -s https://api.greenhired.com/v1/categories \
  -H "Authorization: Bearer $GREENHIRED_API_KEY"

#What you get

One category (the open_jobs number is an example)
JSON
{
  "slug": "renewable-energy",
  "name": "Renewable Energy",
  "sector": "Energy",
  "description": "Generation of energy from solar, wind, hydro, geothermal, tidal, and biomass sources.",
  "open_jobs": 42
}

The answer is { "data": [ ... ] }. open_jobs counts the live jobs this API may show. The counts can be up to a minute old, so there is no need to call this more than once a minute.

#The 28 slugs

renewable-energy, energy-storage-grid, energy-efficiency, climate-tech, carbon-markets, esg-sustainability, conservation-biodiversity, sustainable-agriculture, forestry-land-use, water-management, green-building, smart-cities-urban, clean-transportation-ev, sustainable-aviation-shipping, green-finance, circular-economy, waste-management, sustainable-fashion, environmental-policy-law, environmental-justice, sustainable-tourism, environmental-education, environmental-science, green-chemistry-materials, climate-data-analytics, environmental-health-safety, ocean-blue-economy and air-quality.

Read the list from the endpoint rather than hard-coding it, so you always have the current names and counts.

#Frequently asked questions

Can a job be in more than one category?
A job has one green_category. The category filter on /v1/jobs accepts up to 28 slugs at once, so you can still ask for several categories in one request.
How often do the counts change?
They can be up to a minute old. Cache the answer on your side for at least that long.
Do I filter by slug or by name?
By slug, for example category=renewable-energy. The name is for showing to people.