/meta

Get info on taxonomies, available months of data, available filters and facets, etc.

`GET /meta`

Get 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
`new_taxonomy_versions`	enum	Use new taxonomy versions. This parameter is optional. Default: `False` Must be one of: `false`, `false`
`lot_version`	enum	Specify LOT taxonomy version to use. This parameter is optional. Default: `7` Must be one of: `6`, `7`
`area_version`	enum	Specify area taxonomy version to use. This parameter is optional. Default: `lf_area_2025_1` Must be one of: `lf_area_2025_1`
`area_laa_version`	enum	Specify LAA area taxonomy version to use. This parameter is optional. Default: `2` Must be one of: `1`, `2`
`dataset`	enum	Specify dataset to query. This parameter is optional. Default: `global` Must be one of: `global`, `global_plus`

Code Examples

curl --request GET \
  --url https://api.lightcast.io/global-postings/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",
      "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",
      "city",
      "city_name",
      "common_skills",
      "common_skills_name",
      "company",
      "company_name",
      "contract_type",
      "contract_type_name",
      "edulevels",
      "edulevels_name",
      "employment_type",
      "employment_type_name",
      "isced",
      "isced_name",
      "isco_1",
      "isco_1_name",
      "isco_2",
      "isco_2_name",
      "isco_3",
      "isco_3_name",
      "isco_4",
      "isco_4_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",
      "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",
      "nace_1",
      "nace_1_name",
      "nace_2",
      "nace_2_name",
      "naics2",
      "naics2_name",
      "naics3",
      "naics3_name",
      "naics4",
      "naics4_name",
      "naics5",
      "naics5_name",
      "naics6",
      "naics6_name",
      "remote_type",
      "remote_type_name",
      "skill_categories",
      "skill_categories_name",
      "skill_subcategories",
      "skill_subcategories_name",
      "skills",
      "skills_name",
      "software_skills",
      "software_skills_name",
      "specialized_skills",
      "specialized_skills_name",
      "title",
      "title_name"
    ],
    "filters": [
      "active_sources_info",
      "active_sources_info.source",
      "active_sources_info.type",
      "active_sources_info.url",
      "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",
      "city",
      "city_name",
      "company",
      "company_is_staffing",
      "company_name",
      "contract_type",
      "contract_type_name",
      "edulevels",
      "edulevels_name",
      "employment_type",
      "employment_type_name",
      "isced",
      "isced_name",
      "isco_1",
      "isco_1_name",
      "isco_2",
      "isco_2_name",
      "isco_3",
      "isco_3_name",
      "isco_4",
      "isco_4_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",
      "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",
      "nace_1",
      "nace_1_name",
      "nace_2",
      "nace_2_name",
      "naics2",
      "naics2_name",
      "naics3",
      "naics3_name",
      "naics4",
      "naics4_name",
      "naics5",
      "naics5_name",
      "naics6",
      "naics6_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_subcategories",
      "skill_subcategories_name",
      "skills",
      "skills_name",
      "title",
      "title_name",
      "when"
    ],
    "laa_country_start_month": {
      "AE": "2020-08",
      "AR": "2020-08",
      "AT": "2018-03",
      "AU": "2012-01",
      "BE": "2018-03",
      "BR": "2020-08",
      "CA": "2012-01",
      "CH": "2018-03",
      "CL": "2020-08",
      "CN": "2016-01",
      "CO": "2020-08",
      "CR": "2020-08",
      "CZ": "2018-03",
      "DE": "2018-03",
      "DK": "2018-03",
      "ES": "2018-03",
      "FR": "2018-03",
      "GB": "2012-01",
      "HK": "2020-08",
      "HR": "2018-10",
      "HU": "2018-03",
      "ID": "2020-08",
      "IE": "2018-03",
      "IN": "2020-08",
      "IT": "2014-01",
      "JP": "2020-08",
      "KR": "2020-08",
      "LU": "2018-03",
      "MX": "2020-08",
      "MY": "2020-08",
      "NL": "2018-03",
      "NZ": "2012-09",
      "PH": "2020-08",
      "PL": "2018-03",
      "PR": "2020-08",
      "PT": "2018-03",
      "QA": "2021-01",
      "RO": "2018-03",
      "SE": "2014-12",
      "SG": "2012-01",
      "US": "2010-01",
      "ZA": "2020-08"
    },
    "latest_day": "2026-02-25",
    "metrics": [
      "average_salary",
      "duplicate_postings",
      "max_salary",
      "median_posting_duration",
      "median_salary",
      "min_salary",
      "posting_intensity",
      "significance",
      "total_postings",
      "unique_companies",
      "unique_postings"
    ],
    "nation_start_month": {
      "ARE": "2020-08",
      "ARG": "2020-08",
      "AUS": "2012-01",
      "AUT": "2018-03",
      "BEL": "2018-03",
      "BRA": "2020-08",
      "CAN": "2012-01",
      "CHE": "2018-03",
      "CHL": "2020-08",
      "CHN": "2016-01",
      "COL": "2020-08",
      "CRI": "2020-08",
      "CZE": "2018-03",
      "DEU": "2018-03",
      "DNK": "2018-03",
      "ESP": "2018-03",
      "FRA": "2018-03",
      "GBR": "2012-01",
      "HKG": "2020-08",
      "HRV": "2018-10",
      "HUN": "2018-03",
      "IDN": "2020-08",
      "IND": "2020-08",
      "IRL": "2018-03",
      "ITA": "2014-01",
      "JPN": "2020-08",
      "KOR": "2020-08",
      "LUX": "2018-03",
      "MEX": "2020-08",
      "MYS": "2020-08",
      "NLD": "2018-03",
      "NZL": "2012-09",
      "PHL": "2020-08",
      "POL": "2018-03",
      "PRI": "2020-08",
      "PRT": "2018-03",
      "QAT": "2021-01",
      "ROU": "2018-03",
      "SGP": "2012-01",
      "SWE": "2014-12",
      "USA": "2010-01",
      "ZAF": "2020-08"
    },
    "pipelineVersion": "2026-02",
    "postingFields": [
      "active_sources_info",
      "active_urls",
      "body",
      "city",
      "city_name",
      "company",
      "company_is_staffing",
      "company_name",
      "company_raw",
      "contract_type",
      "contract_type_name",
      "duplicates",
      "edulevels",
      "edulevels_name",
      "employment_type",
      "employment_type_name",
      "expired",
      "id",
      "is_internship",
      "isced",
      "isced_max",
      "isced_max_name",
      "isced_min",
      "isced_min_name",
      "isced_name",
      "isco_1",
      "isco_1_name",
      "isco_2",
      "isco_2_name",
      "isco_3",
      "isco_3_name",
      "isco_4",
      "isco_4_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",
      "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",
      "nace_1",
      "nace_1_name",
      "nace_2",
      "nace_2_name",
      "naics2",
      "naics2_name",
      "naics3",
      "naics3_name",
      "naics4",
      "naics4_name",
      "naics5",
      "naics5_name",
      "naics6",
      "naics6_name",
      "posted",
      "remote_type",
      "remote_type_name",
      "salary",
      "score",
      "skills",
      "skills_name",
      "sources",
      "title",
      "title_name",
      "title_raw",
      "url"
    ],
    "supportsAdvancedFilters": true,
    "taxonomies": {
      "area": "lf_area_2025_1",
      "area_global": "global_area_v1",
      "company": "acme_v2.88.0",
      "isco": "isco_2008",
      "lot": "7",
      "nace": "nace_rev2",
      "naics": "naics_std_2022",
      "skills": "skillsv9.40",
      "title": "emsi_title_v5.54"
    },
    "taxonomy_versions": {
      "area": [
        "lf_area_2025_1"
      ],
      "lot": [
        "7",
        "6"
      ],
      "naics": [
        "naics_std_2022"
      ]
    }
  }
}

// Your request wasn't valid (bad parameter names or values).

{
  "errors": [
    {
      "status": 400,
      "title": "Malformed Request",
      "detail": "Expected array"
    }
  ]
}