/meta
Get info on taxonomies, available months of data, available filters and facets, etc.
GET /meta
GET /metaGet service metadata, including taxonomies, available months of data, facets, metrics, and attribution text. Caching is encouraged, but the metadata does change monthly.
Query Parameters
| Name | Type | Description |
|---|---|---|
noc_version | enum | Specify NOC taxonomy version to use. Default: Must be one of: |
company_version | enum | Specify company taxonomy version to use. Default: Must be one of: |
area_version | enum | Specify area taxonomy version to use. Default: Must be one of: |
area_ca_version | enum | Specify area taxonomy version to use. Default: Must be one of: |
new_taxonomy_versions | enum | Use new taxonomy versions. Must be one of: |
lot_version | enum | Specify LOT taxonomy version to use. Must be one of: |
naics_version | enum | Specify NAICS taxonomy version to use. This parameter is optional. Default: naics_std_2017 Must be one of: naics_std_2017, naics_std_2022 |
naics_standard_version | enum | Specify NAICS taxonomy version to use. Must be one of: |
Code Examples
curl --request GET \
--url https://api.lightcast.io/ca-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",
"cd",
"cd_name",
"certifications",
"certifications_name",
"city",
"city_name",
"cma",
"cma_name",
"common_skills",
"common_skills_name",
"company",
"company_name",
"contract_type",
"contract_type_name",
"csd",
"csd_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",
"language",
"language_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",
"naics2",
"naics2_name",
"naics3",
"naics3_name",
"naics4",
"naics4_name",
"naics5",
"naics5_name",
"naics6",
"naics6_name",
"noc1",
"noc1_name",
"noc2",
"noc2_name",
"noc3",
"noc3_name",
"noc4",
"noc4_name",
"noc5",
"noc5_name",
"pr",
"pr_name",
"province",
"province_name",
"remote_type",
"remote_type_name",
"skill_categories",
"skill_categories_name",
"skill_cluster",
"skill_subcategories",
"skill_subcategories_name",
"skills",
"skills_name",
"software_skills",
"software_skills_name",
"sources",
"specialized_skills",
"specialized_skills_name",
"title",
"title_name"
],
"filters": [
"active_sources_info",
"active_sources_info.source",
"active_sources_info.type",
"active_sources_info.url",
"cd",
"cd_name",
"city",
"city_name",
"cma",
"cma_name",
"company",
"company_is_staffing",
"company_name",
"csd",
"csd_name",
"edulevels",
"edulevels_name",
"employment_type",
"employment_type_name",
"is_internship",
"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",
"language",
"language_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",
"naics2",
"naics2_name",
"naics3",
"naics3_name",
"naics4",
"naics4_name",
"naics5",
"naics5_name",
"naics6",
"naics6_name",
"noc1",
"noc1_name",
"noc2",
"noc2_name",
"noc3",
"noc3_name",
"noc4",
"noc4_name",
"noc5",
"noc5_name",
"pr",
"pr_name",
"province",
"province_name",
"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",
"sources",
"title",
"title_name",
"when",
"when.end",
"when.start",
"when.type"
],
"latest_day": "2026-02-12",
"metrics": [
"average_salary",
"duplicate_postings",
"max_salary",
"median_salary",
"min_salary",
"posting_intensity",
"significance",
"total_postings",
"unique_companies",
"unique_postings"
],
"pipelineVersion": "2026-01",
"postingFields": [
"active_sources_info",
"active_urls",
"body",
"cd",
"cd_name",
"city",
"city_name",
"cma",
"cma_name",
"company",
"company_is_staffing",
"company_name",
"company_raw",
"contract_type",
"contract_type_name",
"csd",
"csd_name",
"duplicates",
"edulevels",
"edulevels_name",
"employment_type",
"employment_type_name",
"expired",
"id",
"is_internship",
"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",
"language",
"language_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",
"naics2",
"naics2_name",
"naics3",
"naics3_name",
"naics4",
"naics4_name",
"naics5",
"naics5_name",
"naics6",
"naics6_name",
"noc1",
"noc1_name",
"noc2",
"noc2_name",
"noc3",
"noc3_name",
"noc4",
"noc4_name",
"noc5",
"noc5_name",
"posted",
"province",
"province_name",
"remote_type",
"remote_type_name",
"salary",
"score",
"skill_categories",
"skill_categories_name",
"skill_subcategories",
"skill_subcategories_name",
"skills",
"skills_name",
"sources",
"title",
"title_name",
"title_raw",
"url"
],
"supportsAdvancedFilters": true,
"taxonomies": {
"area": "ca_area_sgc2021",
"company": "acme_v2.87.0",
"lot": "7",
"naics": "naics_std_2017",
"noc": "ca_noc2021",
"skills": "skillsv9.39",
"title": "emsi_title_v5.53"
},
"taxonomy_versions": {
"area": [
"ca_area_sgc2021",
"ca_area_sgc2016"
],
"company": [
"emsi_company"
],
"lot": [
"7",
"6"
],
"naics": [
"naics_std_2017",
"naics_std_2022"
],
"noc": [
"ca_noc2021"
]
}
}
}