LIlightcast
Rankings

Get timeseries on rankings

Group and rank postings by {rankingFacet} with a monthly or daily timeseries for each ranked group.

Use YYYY-MM date format in the timeseries time-frame filter, timeseries.when, to get monthly summary of each ranked group, or use YYYY-MM-DD date format for daily summary.

post/rankings/{rankingFacet}/timeseries

Request

  • Base URL
    https://api.lightcast.io/global-postings
  • URL
    https://api.lightcast.io/global-postings/rankings/{rankingFacet}/timeseries
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.emsicloud.com/connect/token scopes: postings:global

Path parameters

rankingFacet'anz_sco_1' | 'anz_sco_1_name' | 'anz_sco_2' | 'anz_sco_2_name' | 'anz_sco_3' | 'anz_sco_3_name' | 'anz_sco_4' | 'anz_sco_4_name' | 'anz_sco_5' | 'anz_sco_5_name' | 'anz_sic_1' | 'anz_sic_1_name' | 'anz_sic_2' | 'anz_sic_2_name' | 'anz_sic_3' | 'anz_sic_3_name' | 'anz_sic_4' | 'anz_sic_4_name' | 'certifications' | 'certifications_name' | 'common_skills' | 'common_skills_name' | 'company' | 'company_name' | 'isco_1' | 'isco_1_name' | 'isco_2' | 'isco_2_name' | 'isco_3' | 'isco_3_name' | 'isco_4' | 'isco_4_name' | 'market' | 'market_name' | 'max_years_experience' | 'min_years_experience' | 'nace_1' | 'nace_1_name' | 'nace_2' | 'nace_2_name' | 'nation' | 'nation_name' | 'occupation' | 'occupation_name' | 'skills' | 'skills_name' | 'skill_categories' | 'skill_categories_name' | 'skill_subcategories' | 'skill_subcategories_name' | 'software_skills' | 'software_skills_name' | 'specialized_skills' | 'specialized_skills_name' | 'laa_country' | 'laa_country_name' | 'laa_admin_area_1' | 'laa_admin_area_1_name' | 'laa_admin_area_2' | 'laa_admin_area_2_name' | 'laa_metro' | 'laa_metro_name' | 'remote_type' | 'remote_type_name' | 'naics2' | 'naics2_name' | 'naics3' | 'naics3_name' | 'naics4' | 'naics4_name' | 'naics5' | 'naics5_name' | 'naics6' | 'naics6_name' required

The facet to rank by.

Query parameters

lot_version'6' | '7'
Example:7

Specify LOT taxonomy version to use.

area_version'lf_area_2023_2' | 'lf_area_2025_1'
Example:lf_area_2025_1

Specify area taxonomy version to use.

area_laa_version'1' | '2'
Example:2

Specify LAA area taxonomy version to use.

new_taxonomy_versionstrue | false

Use new taxonomy versions.

Request body

Example request

{
  "filter": {
    "active_sources_info": {
      "type": "Company",
      "source": "ABCRecruiting.com",
      "url": "ABCRecruiting.com/job/GNkBaDoMWiyQbmlpFHfz"
    },
    "when": {
      "start": "2018-06",
      "end": "2019-06"
    },
    "company_is_staffing": true,
    "posting_duration": {
      "upper_bound": 30
    },
    "min_years_experience": {
      "lower_bound": 1,
      "upper_bound": 3
    },
    "max_years_experience": {
      "lower_bound": 4,
      "upper_bound": 6
    },
    "min_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "max_salary": {
      "lower_bound": 55000,
      "upper_bound": 80000
    },
    "salary": {
      "lower_bound": 50000,
      "upper_bound": 200000
    }
  },
  "timeseries": {
    "when": {
      "start": "2018-06",
      "end": "2019-06"
    }
  }
}

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.