How to use the API – industry
Find out how to retrieve data from industry pages using the Careers New Zealand API.
What's on this page?
How to get data
Retrieve data from the industry section of the API by setting the section field to ‘IndustryPage’:
https://api.careers.govt.nz/api/v2/IndustryPage?limit=100
-
This query will return the first 100 industries.
How to filter by industry
To restrict your query to a specific industry, you can filter using the unique industry title or, in most cases, ANZSCO code. For example:
https://api.careers.govt.nz/api/v2/IndustryPage?Title=Hospitality
How to filter content items
An industry pages query can also be restricted by item. There are four relevant content items that make up the industry information.
You can filter by item, as defined in table 2 below, using a question mark in the query string. For example:
https://api.careers.govt.nz/api/v2/IndustryPage?Useful-school-subjects
Table 2 – Industry content items
Item | Description | Example |
Industry-title | Name of the industry | Infrastructure industry |
Maori-title | Māori translation of the industry name (macrons will be parsed) | Whakahaerenga Hanga |
Intro | Summary of the type of activities that work in the industry usually involves | Infrastructure jobs may be for you if you are interested in:
|
Useful-school-subjects | Summary paragraph of the useful school subjects associated with the industry | Useful subjects for this industry include English, maths, sciences and technology at NCEA Level 2 for entry into trades training. For entrance to engineering degrees, maths and sciences are usually the required NCEA Level 3 subjects, and the exact requirements may vary depending on the type of engineering discipline. |
Updated 20 Dec 2018