/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 |
|---|---|---|
area_version | enum | Specify US Area taxonomy version to use. This parameter is optional. Default: Must be one of: |
soc_version | enum | Specify SOC taxonomy version to use. This parameter is optional. Default: Must be one of: |
onet_version | enum | Specify ONET 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: |
naics_version | enum | Specify NAICS 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: |
area_us_version | enum | Specify US Area taxonomy version to use. This parameter is optional. Default: Must be one of: |
soc_lightcast_version | enum | Specify SOC Lightcast taxonomy version to use. This parameter is optional. Default: Must be one of: |
onet_standard_version | enum | Specify ONET Standard taxonomy version to use. This parameter is optional. Default: Must be one of: |
lot_version | enum | Specify LOT taxonomy version to use. This parameter is optional. Default: Must be one of: |
Code Examples
curl --request GET \
--url https://api.lightcast.io/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": [
"2010-01",
"2010-02",
"2010-03",
"2010-04",
"2010-05",
"2010-06",
"2010-07",
"2010-08",
"2010-09",
"2010-10",
"2010-11",
"2010-12",
"2011-01",
"2011-02",
"2011-03",
"2011-04",
"2011-05",
"2011-06",
"2011-07",
"2011-08",
"2011-09",
"2011-10",
"2011-11",
"2011-12",
"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",
"benefit",
"benefit_categories",
"benefit_categories_name",
"benefit_name",
"certifications",
"certifications_name",
"cip2",
"cip2_name",
"cip4",
"cip4_name",
"cip6",
"cip6_name",
"city",
"city_name",
"common_skills",
"common_skills_name",
"company",
"company_name",
"contract_type",
"contract_type_name",
"county",
"county_name",
"edulevels",
"edulevels_name",
"employee_count_range",
"employment_type",
"employment_type_name",
"fips",
"fips_name",
"is_fortune100",
"is_fortune1000",
"is_fortune500",
"job_seniority",
"job_seniority_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",
"lightcast_sectors",
"lightcast_sectors_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",
"msa",
"msa_name",
"naics2",
"naics2_name",
"naics3",
"naics3_name",
"naics4",
"naics4_name",
"naics5",
"naics5_name",
"naics6",
"naics6_name",
"onet",
"onet_name",
"remote_type",
"remote_type_name",
"revenue_bucket",
"skill_categories",
"skill_categories_name",
"skill_subcategories",
"skill_subcategories_name",
"skills",
"skills_name",
"soc2",
"soc2_name",
"soc3",
"soc3_name",
"soc4",
"soc4_name",
"soc5",
"soc5_name",
"software_skills",
"software_skills_name",
"source_types",
"sources",
"specialized_skills",
"specialized_skills_name",
"stars_qualified",
"state",
"state_name",
"title",
"title_name"
],
"filters": [
"active_sources_info",
"active_sources_info.source",
"active_sources_info.type",
"active_sources_info.url",
"benefit",
"benefit_categories",
"benefit_categories_name",
"benefit_name",
"cip2",
"cip2_name",
"cip4",
"cip4_name",
"cip6",
"cip6_name",
"city",
"city_name",
"company",
"company_is_staffing",
"company_name",
"contract_type",
"contract_type_name",
"county",
"county_name",
"edulevels",
"edulevels_name",
"employee_count_range",
"employment_type",
"employment_type_name",
"fips",
"fips_name",
"is_fortune100",
"is_fortune1000",
"is_fortune500",
"is_hwol",
"is_internship",
"is_supervisor",
"job_seniority",
"job_seniority_name",
"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",
"lightcast_sectors",
"lightcast_sectors_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",
"msa",
"msa_name",
"naics2",
"naics2_name",
"naics3",
"naics3_name",
"naics4",
"naics4_name",
"naics5",
"naics5_name",
"naics6",
"naics6_name",
"onet",
"onet_name",
"posting_duration",
"posting_duration.lower_bound",
"posting_duration.upper_bound",
"remote_type",
"remote_type_name",
"revenue_bucket",
"salary",
"salary.lower_bound",
"salary.upper_bound",
"skill_categories",
"skill_categories_name",
"skill_subcategories",
"skill_subcategories_name",
"skills",
"skills_name",
"soc2",
"soc2_name",
"soc3",
"soc3_name",
"soc4",
"soc4_name",
"soc5",
"soc5_name",
"source_types",
"sources",
"stars_qualified",
"state",
"state_name",
"title",
"title_name",
"when",
"when.end",
"when.start",
"when.type"
],
"latest_day": "2026-02-09",
"metrics": [
"average_salary",
"duplicate_postings",
"max_salary",
"median_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",
"benefit",
"benefit_categories",
"benefit_categories_name",
"benefit_name",
"body",
"cip2",
"cip2_name",
"cip4",
"cip4_name",
"cip6",
"cip6_name",
"city",
"city_name",
"company",
"company_is_staffing",
"company_name",
"company_raw",
"contract_type",
"contract_type_name",
"county",
"county_name",
"duplicates",
"duration",
"edulevels",
"edulevels_name",
"employee_count_range",
"employment_type",
"employment_type_name",
"expired",
"id",
"is_fortune100",
"is_fortune1000",
"is_fortune500",
"is_hwol",
"is_internship",
"is_supervisor",
"job_seniority",
"job_seniority_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",
"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",
"msa",
"msa_name",
"naics2",
"naics2_name",
"naics3",
"naics3_name",
"naics4",
"naics4_name",
"naics5",
"naics5_name",
"naics6",
"naics6_name",
"onet",
"onet_name",
"posted",
"remote_type",
"remote_type_name",
"revenue_bucket",
"salary",
"score",
"skill_categories",
"skill_categories_name",
"skill_subcategories",
"skill_subcategories_name",
"skills",
"skills_name",
"soc2",
"soc2_name",
"soc3",
"soc3_name",
"soc4",
"soc4_name",
"soc5",
"soc5_name",
"source_types",
"sources",
"stars_qualified",
"state",
"state_name",
"title",
"title_name",
"title_raw",
"url"
],
"supportsAdvancedFilters": true,
"taxonomies": {
"area": "us_area_2024_4",
"cip": "cip2020",
"company": "acme_v2.87.0",
"lot": "7",
"naics": "naics_std_2022",
"onet": "onet26_emsi",
"skills": "skillsv9.39",
"soc": "soc_2021",
"title": "emsi_title_v5.53"
},
"taxonomy_versions": {
"area": [
"us_area_2024_4",
"us_area_2024_3"
],
"company": [
"emsi_company"
],
"lot": [
"7",
"6"
],
"naics": [
"naics_std_2022"
],
"onet": [
"onet_2019"
],
"soc": [
"soc_2021"
],
"title": [
"emsi"
]
}
}
}//Your request wasn't valid (bad parameter names or values).
{
"errors": [
{
"status": 400,
"title": "Malformed Request",
"detail": "Expected array"
}
]
}