Endpoint Examples

GET /meta

Get service metadata, including taxonomies and attribution text. Caching is encouraged, but the metadata may change weekly.

Query Parameters

NameTypeDescription
new_taxonomy_versionsenumUse new taxonomy versions. Optional. Must be one of: true, false.
lot_versionenumSpecify LOT taxonomy version to use. Optional. Default: 7. Must be one of: 6, 7.
naics_versionenumSpecify NAICS taxonomy version to use. Optional. Default: naics_std_2022. Must be one of: naics_std_2022, naics_std_2017.
area_versionenumSpecify area taxonomy version to use. Optional. Default: lf_area_2025_1. Must be one of: lf_area_2023_2, lf_area_2025_1.
area_laa_versionenumSpecify LAA area taxonomy version to use. Optional. Default: 2. Must be one of: 1, 2.

Code Examples

curl -X GET 'https://api.lightcast.io/global-profiles/meta' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

Response Examples

{
  "data": {
    "attribution": {
      "body": "Lightcast Global profiles are collected from various public online sources and processed/enriched to provide information such as standardized company name, occupation, skills, and geography.",
      "title": "Lightcast Global Profiles"
    },
    "earliest_year": "2019",
    "facets": [
      "certifications",
      "certifications_name",
      "common_skills",
      "common_skills_name",
      "company",
      "company_name",
      "gender",
      "gender_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",
      "market",
      "market_name",
      "most_recent_company",
      "most_recent_company_end_date",
      "most_recent_company_start_date",
      "moves_in_most_recent_company",
      "nation",
      "nation_name",
      "occupation",
      "occupation_name",
      "onet",
      "onet_name",
      "previous_company",
      "previous_company_end_date",
      "previous_company_start_date",
      "schools",
      "schools_name",
      "skills",
      "skills_name",
      "specialized_skills",
      "specialized_skills_name",
      "title",
      "title_name",
      "years_in_current_role",
      "years_of_experience",
      "years_with_most_recent_company",
      "skill_categories",
      "skill_categories_name",
      "skill_subcategories",
      "skill_subcategories_name",
      "naics2",
      "naics2_name",
      "naics3",
      "naics3_name",
      "naics4",
      "naics4_name",
      "naics5",
      "naics5_name",
      "naics6",
      "naics6_name"
    ],
    "filters": [
      "company",
      "company_name",
      "educations",
      "educations.schools",
      "educations.schools_name",
      "gender",
      "gender_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",
      "market",
      "market_name",
      "most_recent_company",
      "most_recent_company_end_date",
      "most_recent_company_start_date",
      "moves_in_most_recent_company",
      "nation",
      "nation_name",
      "occupation",
      "occupation_name",
      "onet",
      "onet_name",
      "previous_company",
      "previous_company_end_date",
      "previous_company_start_date",
      "skills",
      "skills_name",
      "title",
      "title_name",
      "years_in_current_role",
      "years_of_experience",
      "years_with_most_recent_company",
      "skill_categories",
      "skill_categories_name",
      "skill_subcategories",
      "skill_subcategories_name",
      "naics2",
      "naics2_name",
      "naics3",
      "naics3_name",
      "naics4",
      "naics4_name",
      "naics5",
      "naics5_name",
      "naics6",
      "naics6_name"
    ],
    "latest_year": "2024",
    "metrics": [
      "profiles",
      "significance",
      "unique_companies"
    ],
    "supportsAdvancedFilters": true,
    "taxonomies": {
      "area": "lf_area_2025_1",
      "area_global": "global_area_v1",
      "company": "2.73.0",
      "lot": "6",
      "naics": "naics_std_2022",
      "occupation_global": "global_occ_v1",
      "onet": "onet24_emsi",
      "skills": "9.25",
      "title": "5.39"
    },
    "taxonomy_versions": {
      "lot": [
        "6",
        "7"
      ],
      "area": [
        "lf_area_2025_1",
        "lf_area_2023_2"
      ],
      "naics": [
        "naics_std_2022",
        "naics_std_2017"
      ]
    },
    "pipelineVersion": "2025-07"
  }
}