Adzuna Intelligence API
HomeKnowledge BaseAbout
HomeKnowledge BaseAbout
  1. Complex Queries
  • Introduction
  • Access and Authentication
  • Taxonomies
  • Core Demand Data
    • Overview
    • Get the total number of postings
      GET
    • Get the total number of postings over time
      GET
    • Get the number of new postings
      GET
    • Get the number of new postings over time
      GET
    • Get posting duration data
      GET
    • Get time to fill data
      GET
  • Interest Quotient Data
    • Overview
    • Get interest quotient
      GET
    • Get interest quotient over time
      GET
  • Compensation Data
    • List job benefits
      GET
    • Search job benefits
      GET
    • Get mean and median salary
      GET
    • Get mean and median salary over time
      GET
    • Get salary distribution data
      GET
    • Get benefits offered
      GET
  • Location Data
    • List countries
    • List location (statistical area) types
    • List locations (statistical areas)
    • Search locations (statistical areas)
    • Get location quotient
    • Compare job demand acrosss geographic areas
    • Compare interest quotient across geographic areas
    • Compare location quotient across geographic areas
    • Compare median salary across geographic areas
  • Occupation Data
    • List occupation taxonomies
    • List occupation sectors (categories)
    • Search occupation sectors (categories)
    • List occupations
    • Search occupations
    • Get occupation sectors (categories) in demand
    • Get occupations in demand
    • Get popular occupation sectors (categories)
    • Get popular occupations
  • Industry Data
    • List industries
    • Search industries
    • Get industries hiring
    • Get popular industries
  • Skill Data
    • List skill taxonomies
    • List skill tags
    • Search skill tags
    • List skills
    • Search skills
    • Get requested skills
  • Education Data
    • List education levels
    • Search education levels
    • List education qualifications
    • Search education qualifications
    • Get requested education attainment
  • Apprenticeship Data
    • List apprenticeship levels
    • Search apprenticeship levels
    • List apprenticeship types
    • Search apprenticeship types
    • Get requested apprenticeship levels
  • Company and Employer Data
    • List companies
    • Search companies
    • Get companies hiring
    • Get popular employers
  • Public data
    • Claimant count
    • Gender pay gap
    • Job Density
  • Complex Queries
    • Overview
    • Defining a query
    • Specifying the primary metric
    • Specifying a date range
    • Supported dimensions
    • Specifying filters
    • Specifying a breakdown
    • Example queries
    • Performing a complex boolean query
      POST
  1. Complex Queries

Example queries

Example 1#

"Hey Adzuna, tell me the overall job demand (unique postings) in the UK for March 2024"
{
    "query": {
        "metric": "demand",
        "date_range": {
            "type": "absolute",
            "start": "2024-03-01",
            "end": "2024-03-31"
        }
    }
}

Example 2#

"Hey Adzuna, tell me the median salary in the UK over the past year, broken down by ITL/NUTS 1 region"
{
    "query": {
        "metric": "salary",
        "date_range": {
            "type": "relative",
            "last_n_days": 365
        },
        "breakdown": {
            "dimension": "location",
            "location_type_id": 20
        }
    }
}

Example 3#

Hey Adzuna, tell me the overall demand in the last 6 months in South East England (ITL/NUTS 1) but excluding the London Travel to Work Area, for occupations that are within the Information Technology Professionals SOC Minor Group (213) and are specifically requesting Java as a skill. Limit the data to the Information and Telecommunications industry (SIC major section J), and break the results down at 4 digit SOC occupation level!
{
    "query": {
        "metric": "demand",
        "date_range": {
            "type": "relative",
            "last_n_days": 182
        },
        "filter": {
            "type": "combined_rule",
            "logic": "and",
            "groups": [
                {
                    "type": "combined_rule",
                    "logic": "and",
                    "groups": [
                        {
                            "type": "rule",
                            "dimension": "location",
                            "operator": "eq",
                            "target": {
                                "type": "object",
                                "id": 27,
                                "name": "South East (England)"
                            }
                        },
                        {
                            "type": "rule",
                            "dimension": "location",
                            "operator": "neq",
                            "target": {
                                "type": "object",
                                "id": 501,
                                "name": "London"
                            }
                        }
                    ]
                },
                {
                    "type": "rule",
                    "dimension": "occupation",
                    "operator": "eq",
                    "target": {
                        "type": "object",
                        "id": 213,
                        "name": "Information Technology Professionals"
                    },
                    "taxonomy_id": 3
                },
                {
                    "type": "rule",
                    "dimension": "skill",
                    "operator": "eq",
                    "target": {
                        "type": "object",
                        "id": 35089,
                        "name": "Java"
                    },
                    "taxonomy_id": 1
                },
                {
                    "type": "rule",
                    "dimension": "industry",
                    "operator": "eq",
                    "target": {
                        "type": "object",
                        "id": "J",
                        "name": "Information and communication"
                    }
                }
            ]
        },
        "breakdown": {
            "dimension": "occupation",
            "taxonomy_id": 2
        }
    }
}
Previous
Specifying a breakdown
Next
Performing a complex boolean query
Built with