Endpoint URL: http://api.careerbuilder.com/v1/categories
Default response format: XML
Categories (sometimes called Job Type Codes) are used in job searches to constrain results to a particular field or fields.
When specifying a category in an API search, you have the option of using human-readable category names (e.g. Accounting) or category codes (e.g. JN001). Since category codes may vary from country to country, use the categories service to view the list of available codes and names.
The request will return the category names in the language(s) supported by the country requested as well as "en-US". The ISO language code will be listed in the "language" attribute of the Name node. A multilingual country will return at least three different names for each category code.
Use caution when working with category codes, as we may change their values at any time. Remember to URL encode category names in your search parameters.
GET requests only.
| v1/categories parameters | |||
| Parameter name | Required? | XSD type | Notes |
|---|---|---|---|
| DeveloperKey | Yes | string | 20 character long CB API Developer Key. |
| CountryCode | No | string | Accepts a single value only. Supported codes: AH, B1, B2, B3, B4, BE, C1, CA, CC, CE, CH, CN, CP, CS, CY, DE, DK, E1, ER, ES, EU, F1, FR, GC, GR, I1, IE, IN, IT, J1, JC, JS, LJ, M1, MC, MY, NL, NO, O1, OG, PD, PI, PL, RM, RO, RX, S1, SE, SF, SG, T1, T2, T3, UK, US, WH, WM, WR. Missing or Unsupported Codes Default to: US |
<?xml version="1.0" encoding="UTF-8" ?>
<ResponseCategories>
<Errors/>
<TimeResponseSent>2/5/2008 4:14:10 PM</TimeResponseSent>
<Categories>
<Category>
<Code>JN001</Code>
<Name language="en-US">Accounting</Name>
</Category>
<Category>
<Code>JN002</Code>
<Name language="en-US">Admin - Clerical</Name>
</Category>
<Category>
<Code>JN054</Code>
<Name language="en-US">Automotive</Name>
</Category>
.
.
.
</Categories>
</ResponseCategories>