Adzuna Intelligence API
Home
Knowledge Base
About
Adzuna Intelligence API
  • Introduction
  • Access and Authentication
  • Taxonomies
  • Core Demand Data
  • Interest Quotient Data
    • Overview
    • Get interest quotientGET
    • Get interest quotient over timeGET
  • Compensation Data
  • Location Data
  • Occupation Data
  • Industry Data
  • Skill Data
  • Education Data
  • Apprenticeship Data
  • Company and Employer Data
  • Public data
  • Complex Queries
logoPowered by Apidog
  1. Interest Quotient Data

Get interest quotient over time

GET/api/v1.1/{country_code}/reports/interest-quotient-trend/

Returns the interest quotient for postings matching the given criteria over the given time period, as a function of time.

Data is returned at weekly intervals over the requested time period.

This data is commonly used for generating time series charts.

:::info
This endpoint allows querying by one primary facet type (location, occupation, skill, industry, employer) only. Multiple values of the same facet may be provided, in which case, they will be aggregated.
:::

Request

Authorization: API Key
Add parameter in header
Authorization
Example
Authorization: 2f68dbbf-519d-4f01-9636-e2421b68f379
Path Params
country_code
string 
required

A two character code that specifies which country dataset to query.

Example:
gb
Match pattern:
^[a-z]{2}$
Query Params
category_id
array[integer]
optional

A unique ID specifying an occupation sector/category.

company_id
array[integer]
optional

A unique ID specifying a company/employer.

end_date
string <date>
required

The end date of the desired time period for the query. Must be specified in ISO8601 format (YYYY-MM-DD).

Example:
2022-01-31
industry_id
array[string]
optional

A unique ID specifying an industry.

location_id
array[integer]
required

A unique ID specifying a location/statistical area.

Example:
26
occupation_id
array[integer]
optional

A unique ID specifying an occupation (job title). If specified, an occupation_taxonomy_id must also be provided.

occupation_taxonomy_id
integer 
optional

A unique ID specifying an occupation taxonomy. Required when specifying an occupation_id.

>= 1
skill_id
array[integer]
optional

A unique ID specifying a skill.

skill_tag_id
array[integer]
optional

A unique ID specifying a skill tag (pre-defined group of skills).

start_date
string <date>
required

The start date of the desired time period for the query. Must be specified in ISO8601 format (YYYY-MM-DD).

Example:
2022-01-01

Request samples

Responses

Request successful.(200)
Request successful.
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
array of:
date
string <date>
required

A date in the time series, specified in ISO8601 format (YYYY-MM-DD).

interest_quotient
number <double>
required

The interest quotient value for postings matching the query on the week ending on the corresponding date.

Example
Not configured
Last modified: 6 months ago