Specifying a breakdown

If you want to analyse a metric broken down by one or more specific dimensions, rather a single aggregated value, you can specify an array of Breakdown objects in your query.

A maximum of 2 breakdown dimensions can be specified - useful for cross-tab reporting!

Breakdown

dimension

enum<string>

required

The dimension (facet) by which to breakdown the results..

Allowed values:

apprenticeship_levelapprenticeship_typecategorycompanycontract_hourscontract_typeeducation_levelindustrylocationoccupationqualificationsalaryseniorityskillskill_tagworkplace_modelyears_of_experience

taxonomy_id

integer

optional

If the breakdown dimension is occupation or skill, a taxonomy ID is required.

location_type_id

integer

optional

If the breakdown dimension is location, a location type ID must be provided.

Examples

Example 1

Specify that the results should be broken down by Adzuna Job Title (occupation taxonomy ID = 1):

"breakdown": [
    {
        "dimension": "occupation",
        "taxonomy_id": 1
    }
]

Example 2

Specify that the results should be broken down by company (employer) and then by contract type:

"breakdown": [
    {
        "dimension": "company"
    },
    {
        "dimension": "contract_type"
    }
]

Examples#

Example 1#

Example 2#

Examples

Example 1

Example 2