Performing a complex boolean query

POST

https://api.intelligence.adzuna.com/api/v1.1/{country_code}/query-builder/run-query/

Supports running complex boolean queries on our dataset.

Queries can be based around a demand or salary primary metric, contain one or more filter rules, and an optional breakdown.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Body Params application/json

Example

{
    "metric": "demand",
    "date_range": {
        "type": "absolute",
        "start": "2023-07-19",
        "end": "2024-07-22"
    },
    "filter": {
        "type": "rule",
        "dimension": "apprenticeship_level",
        "operator": "eq",
        "target": {
            "type": "object",
            "id": 0,
            "name": "string"
        },
        "taxonomy_id": 0
    },
    "breakdown": [
        {
            "dimension": "apprenticeship_level",
            "taxonomy_id": 0,
            "location_type_id": 0
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.intelligence.adzuna.com/api/v1.1/gb/query-builder/run-query/' \
--header 'Content-Type: application/json' \
--header 'Authorization;' \
--data-raw '{
    "metric": "demand",
    "date_range": {
        "type": "absolute",
        "start": "2023-07-19",
        "end": "2024-07-22"
    },
    "filter": {
        "type": "rule",
        "dimension": "apprenticeship_level",
        "operator": "eq",
        "target": {
            "type": "object",
            "id": 0,
            "name": "string"
        },
        "taxonomy_id": 0
    },
    "breakdown": [
        {
            "dimension": "apprenticeship_level",
            "taxonomy_id": 0,
            "location_type_id": 0
        }
    ]
}'

Responses

🟢200No response body

application/json

Body

Example

{
    "metric": "demand",
    "key_metrics": {
        "metric_value": {
            "demand": 0
        }
    },
    "breakdown_dimension": "apprenticeship_level",
    "breakdown": [
        {
            "metric_value": {
                "demand": 0
            },
            "breakdown_value": {
                "id": 0,
                "name": "string"
            }
        }
    ],
    "raw": [
        {
            "date": "2019-08-24T14:15:22Z",
            "metric_value": {
                "demand": 0
            },
            "breakdown_value": {
                "id": 0,
                "name": "string"
            }
        }
    ]
}

Modified at 2025-06-04 17:06:24

Example queries