/meta
Get info on taxonomies, versioning, available months of data, etc.
GET /meta
GET /metaGet service metadata, including taxonomies, version, available months of data, facets, metrics, and attribution text. Caching is encouraged, but the metadata does change monthly.
Query Parameters
| Name | Type | Description |
|---|---|---|
soc_version | enum | Specify SOC taxonomy version to use. This parameter is optional. Default: Must be one of: |
area_version | enum | Specify area taxonomy version to use. This parameter is optional. Default: Must be one of: |
title_version | enum | Specify Job Title taxonomy version to use. This parameter is optional. Default: Must be one of: |
company_version | enum | Specify company taxonomy version to use. This parameter is optional. Default: Must be one of: |
new_taxonomy_versions | enum | Use new taxonomy versions. This parameter is optional. Must be one of: |
lot_version | enum | Specify LOT taxonomy version to use. This parameter is optional. Must be one of: |
Code Examples
curl --request GET \
--url https://api.lightcast.io/uk-jpa/meta \
--header 'Authorization: Bearer <ACCESS_TOKEN>'Response Examples
{
"data": {
"attribution": {
"body": "Job postings are collected from various sources and processed/enriched to provide information such as standardized company name, occupation, skills, and geography.",
"title": "Lightcast Job Postings"
},
"available_months": [
"2012-01",
"2012-02",
"2012-03",
"2012-04",
"2012-05",
"2012-06",
"2012-07",
"2012-08",
"2012-09",
"2012-10",
"2012-11",
"2012-12",
"2013-01",
"2013-02",
"2013-03",
"2013-04",
"2013-05",
"2013-06",
"2013-07",
"2013-08",
"2013-09",
"2013-10",
"2013-11",
"2013-12",
"2014-01",
"2014-02",
"2014-03",
"2014-04",
"2014-05",
"2014-06",
"2014-07",
"2014-08",
"2014-09",
"2014-10",
"2014-11",
"2014-12",
"2015-01",
"2015-02",
"2015-03",
"2015-04",
"2015-05",
"2015-06",
"2015-07",
"2015-08",
"2015-09",
"2015-10",
"2015-11",
"2015-12",
"2016-01",
"2016-02",
"2016-03",
"2016-04",
"2016-05",
"2016-06",
"2016-07",
"2016-08",
"2016-09",
"2016-10",
"2016-11",
"2016-12",
"2017-01",
"2017-02",
"2017-03",
"2017-04",
"2017-05",
"2017-06",
"2017-07",
"2017-08",
"2017-09",
"2017-10",
"2017-11",
"2017-12",
"2018-01",
"2018-02",
"2018-03",
"2018-04",
"2018-05",
"2018-06",
"2018-07",
"2018-08",
"2018-09",
"2018-10",
"2018-11",
"2018-12",
"2019-01",
"2019-02",
"2019-03",
"2019-04",
"2019-05",
"2019-06",
"2019-07",
"2019-08",
"2019-09",
"2019-10",
"2019-11",
"2019-12",
"2020-01",
"2020-02",
"2020-03",
"2020-04",
"2020-05",
"2020-06",
"2020-07",
"2020-08",
"2020-09",
"2020-10",
"2020-11",
"2020-12",
"2021-01",
"2021-02",
"2021-03",
"2021-04",
"2021-05",
"2021-06",
"2021-07",
"2021-08",
"2021-09",
"2021-10",
"2021-11",
"2021-12",
"2022-01",
"2022-02",
"2022-03",
"2022-04",
"2022-05",
"2022-06",
"2022-07",
"2022-08",
"2022-09",
"2022-10",
"2022-11",
"2022-12",
"2023-01",
"2023-02",
"2023-03",
"2023-04",
"2023-05",
"2023-06",
"2023-07",
"2023-08",
"2023-09",
"2023-10",
"2023-11",
"2023-12",
"2024-01",
"2024-02",
"2024-03",
"2024-04",
"2024-05",
"2024-06",
"2024-07",
"2024-08",
"2024-09",
"2024-10",
"2024-11",
"2024-12",
"2025-01",
"2025-02",
"2025-03",
"2025-04",
"2025-05",
"2025-06",
"2025-07",
"2025-08",
"2025-09",
"2025-10",
"2025-11",
"2025-12",
"2026-01"
],
"distributionFacets": [
"max_years_experience",
"min_years_experience",
"posting_duration",
"salary"
],
"facets": [
"active_sources_info",
"certifications",
"certifications_name",
"city",
"city_name",
"common_skills",
"common_skills_name",
"company",
"company_name",
"contract_type",
"contract_type_name",
"country",
"country_name",
"edulevels",
"edulevels_name",
"employment_type",
"employment_type_name",
"laa_admin_area_1",
"laa_admin_area_1_name",
"laa_admin_area_2",
"laa_admin_area_2_name",
"laa_country",
"laa_country_name",
"laa_metro",
"laa_metro_name",
"lau1",
"lau1_name",
"lot_career_area",
"lot_career_area_name",
"lot_occupation",
"lot_occupation_group",
"lot_occupation_group_name",
"lot_occupation_name",
"lot_specialized_occupation",
"lot_specialized_occupation_name",
"max_edulevels",
"max_edulevels_name",
"max_years_experience",
"min_edulevels",
"min_edulevels_name",
"min_years_experience",
"nuts1",
"nuts1_name",
"nuts3",
"nuts3_name",
"remote_type",
"remote_type_name",
"skill_categories",
"skill_categories_name",
"skill_cluster",
"skill_subcategories",
"skill_subcategories_name",
"skills",
"skills_name",
"soc1",
"soc1_name",
"soc2",
"soc2_name",
"soc3",
"soc3_name",
"soc4",
"soc4_name",
"software_skills",
"software_skills_name",
"sources",
"specialized_skills",
"specialized_skills_name",
"title",
"title_name",
"ttwa",
"ttwa_name",
"uk_sic_1",
"uk_sic_1_name",
"uk_sic_2",
"uk_sic_2_name",
"uk_sic_3",
"uk_sic_3_name",
"uk_sic_4",
"uk_sic_4_name",
"uk_sic_5",
"uk_sic_5_name"
],
"filters": [
"active_sources_info",
"active_sources_info.source",
"active_sources_info.type",
"active_sources_info.url",
"city",
"city_name",
"company",
"company_is_staffing",
"company_name",
"contract_type",
"contract_type_name",
"country",
"country_name",
"edulevels",
"edulevels_name",
"employment_type",
"employment_type_name",
"is_apprenticeship",
"is_internship",
"is_voluntary",
"keywords",
"keywords.query",
"keywords.type",
"laa_admin_area_1",
"laa_admin_area_1_name",
"laa_admin_area_2",
"laa_admin_area_2_name",
"laa_country",
"laa_country_name",
"laa_metro",
"laa_metro_name",
"lau1",
"lau1_name",
"lot_career_area",
"lot_career_area_name",
"lot_occupation",
"lot_occupation_group",
"lot_occupation_group_name",
"lot_occupation_name",
"lot_specialized_occupation",
"lot_specialized_occupation_name",
"max_edulevels",
"max_edulevels_name",
"max_salary",
"max_salary.lower_bound",
"max_salary.upper_bound",
"max_years_experience",
"max_years_experience.lower_bound",
"max_years_experience.upper_bound",
"min_edulevels",
"min_edulevels_name",
"min_salary",
"min_salary.lower_bound",
"min_salary.upper_bound",
"min_years_experience",
"min_years_experience.lower_bound",
"min_years_experience.upper_bound",
"nuts1",
"nuts1_name",
"nuts3",
"nuts3_name",
"posting_duration",
"posting_duration.lower_bound",
"posting_duration.upper_bound",
"remote_type",
"remote_type_name",
"salary",
"salary.lower_bound",
"salary.upper_bound",
"skill_categories",
"skill_categories_name",
"skill_cluster",
"skill_subcategories",
"skill_subcategories_name",
"skills",
"skills_name",
"soc1",
"soc1_name",
"soc2",
"soc2_name",
"soc3",
"soc3_name",
"soc4",
"soc4_name",
"sources",
"title",
"title_name",
"ttwa",
"ttwa_name",
"uk_sic_1",
"uk_sic_1_name",
"uk_sic_2",
"uk_sic_2_name",
"uk_sic_3",
"uk_sic_3_name",
"uk_sic_4",
"uk_sic_4_name",
"uk_sic_5",
"uk_sic_5_name",
"when",
"when.end",
"when.start",
"when.type"
],
"latest_day": "2026-02-11",
"metrics": [
"average_salary",
"duplicate_postings",
"max_salary",
"median_posting_duration",
"median_salary",
"min_salary",
"posting_intensity",
"significance",
"total_postings",
"unique_companies",
"unique_postings"
],
"pipelineVersion": "2026-01",
"postingFields": [
"active_sources_info",
"active_urls",
"body",
"city",
"city_name",
"company",
"company_is_staffing",
"company_name",
"company_raw",
"country",
"country_name",
"duplicates",
"duration",
"edulevels",
"edulevels_name",
"employment_type",
"employment_type_name",
"expired",
"id",
"is_apprenticeship",
"is_internship",
"is_voluntary",
"laa_admin_area_1",
"laa_admin_area_1_name",
"laa_admin_area_2",
"laa_admin_area_2_name",
"laa_country",
"laa_country_name",
"laa_metro",
"laa_metro_name",
"lau1",
"lau1_name",
"location",
"lot_career_area",
"lot_career_area_name",
"lot_occupation",
"lot_occupation_group",
"lot_occupation_group_name",
"lot_occupation_name",
"lot_specialized_occupation",
"lot_specialized_occupation_name",
"max_edulevels",
"max_edulevels_name",
"max_salary",
"max_years_experience",
"min_edulevels",
"min_edulevels_name",
"min_salary",
"min_years_experience",
"nuts1",
"nuts1_name",
"nuts3",
"nuts3_name",
"posted",
"remote_type",
"remote_type_name",
"salary",
"score",
"skill_categories",
"skill_categories_name",
"skill_subcategories",
"skill_subcategories_name",
"skills",
"skills_name",
"soc1",
"soc1_name",
"soc2",
"soc2_name",
"soc3",
"soc3_name",
"soc4",
"soc4_name",
"sources",
"title",
"title_name",
"title_raw",
"ttwa",
"ttwa_name",
"uk_sic_1",
"uk_sic_1_name",
"uk_sic_2",
"uk_sic_2_name",
"uk_sic_3",
"uk_sic_3_name",
"uk_sic_4",
"uk_sic_4_name",
"uk_sic_5",
"uk_sic_5_name",
"url"
],
"supportsAdvancedFilters": true,
"taxonomies": {
"area": "uk_area_2015",
"company": "emsi-company_vacme_v2.87.0",
"lot": "7",
"sic": "uk_sic2007emsi",
"skills": "skillsv9.39",
"soc": "uk_soc_2020",
"title": "emsi_title_v5.53",
"ttwa": "2011"
},
"taxonomy_versions": {
"area": [
"uk_area_2015"
],
"company": [
"emsi_company"
],
"lot": [
"7",
"6"
],
"soc": [
"uk_soc_2020"
],
"title": [
"emsi"
]
}
}
}