Status Page
API Reference

Endpoint Examples

/rankings

Group and rank profiles by available facets.

GET /rankings

Get a list of current available ranking facets.

Code Examples

curl --request GET \
  --url https://api.lightcast.io/global-profiles/rankings \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Response Examples

{
  "data": [
    "certifications",
    "certifications_name",
    "company",
    "company_name",
    "gender",
    "gender_name",
    "grad_year",
    "laa_country",
    "laa_country_name",
    "laa_metro",
    "laa_metro_name",
    "laa_admin_area_1",
    "laa_admin_area_1_name",
    "laa_admin_area_2",
    "laa_admin_area_2_name",
    "language",
    "specialized_skills",
    "specialized_skills_name",
    "common_skills",
    "common_skills_name",
    "onet",
    "onet_name",
    "schools",
    "schools_name",
    "skills",
    "skills_name",
    "title",
    "title_name",
    "city",
    "city_name"
  ]
}

POST /rankings/[rankingFacet]

Path Parameters

NameDescription
rankingFacet
enum

Example: title_name

Must be one of: certifications, certifications_name, city, city_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, language, 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, most_recent_company, most_recent_company_end_date, most_recent_company_start_date, moves_in_most_recent_company, moves_in_previous_company, onet, onet_name, previous_company, previous_company_end_date, previous_company_start_date, schools, schools_name, skills, skills_name, software_skills, software_skills_name, specialized_skills, specialized_skills_name, title, title_name, years_in_current_role, years_of_work_history, years_with_most_recent_company, years_with_previous_company, skill_categories, skill_categories_name, skills_subcategories, skills_subcategories_name, naics2, naics2_name, naics3, naics3_name, naics4, naics4_name, naics5, naics5_name, naics6, naics6_name

Query Parameters

NameDescription
new_taxonomy_versions
enum		Use new taxonomy versions.
This parameter is optional.
Must be one of: true, false
lot_version
enum		Specify LOT taxonomy version to use.
This parameter is optional.
Default: 7
Must be one of: 6, 7
naics_version
enum		Specify NAICS taxonomy version to use.
This parameter is optional.
Default: naics_std_2022
Must be one of: naics_std_2022, naics_std_2017
area_version
enum		Specify area taxonomy version to use.
This parameter is optional.
Default: lf_area_2025_1
Must be one of: lf_area_2023_2, 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

Request Body

{
  "filter": {
    "skills_name": [
      "SQL (Programming Language)"
    ]
  },
  "rank": {
    "by": "profiles",
    "limit": 5,
    "extra_metrics": [
      "unique_companies"
    ],
    "min_profiles": 1
  }
}

Code Examples

curl --request POST \
  --url https://api.lightcast.io/global-profiles/rankings/{rankingFacet} \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{ "filter": { "skills_name": [ "SQL (Programming Language)" ] }, "rank": { "by": "profiles", "limit": 5, "extra_metrics": [ "unique_companies" ], "min_profiles": 1 } }'

Response Examples

{
  "data": {
    "ranking": {
      "buckets": [
        {
          "name": "Software Engineer",
          "profiles": 3384,
          "unique_companies": 1364
        },
        {
          "name": "Software Developer",
          "profiles": 3308,
          "unique_companies": 1817
        },
        {
          "name": "Analyst/Manager",
          "profiles": 3004,
          "unique_companies": 821
        },
        {
          "name": ".NET Software Engineer",
          "profiles": 2650,
          "unique_companies": 881
        },
        {
          "name": "Business Analyst",
          "profiles": 1958,
          "unique_companies": 1168
        }
      ],
      "facet": "title_name",
      "limit": 5,
      "rank_by": "profiles"
    },
    "totals": {
      "profiles": 125286,
      "unique_companies": 20934
    }
  }
}

POST /rankings/{rankingFacet}/rankings/{nestedRankingFacet}

Get a nested ranking (e.g. top companies, then top skills per company).

Path Parameters

NameDescription
rankingFacet
enum

Example: title_name

Must be one of: certifications, certifications_name, city, city_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, language, 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, most_recent_company, most_recent_company_end_date, most_recent_company_start_date, moves_in_most_recent_company, moves_in_previous_company, onet, onet_name, previous_company, previous_company_end_date, previous_company_start_date, schools, schools_name, skills, skills_name, software_skills, software_skills_name, specialized_skills, specialized_skills_name, title, title_name, years_in_current_role, years_of_work_history, years_with_most_recent_company, years_with_previous_company, skill_categories, skill_categories_name, skills_subcategories, skills_subcategories_name, naics2, naics2_name, naics3, naics3_name, naics4, naics4_name, naics5, naics5_name, naics6, naics6_name

nestedRankingFacet enum

Example: title_name

Must be one of: certifications, certifications_name, city, city_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, language, 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, most_recent_company, most_recent_company_end_date, most_recent_company_start_date, moves_in_most_recent_company, moves_in_previous_company, 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_work_history, years_with_most_recent_company, years_with_previous_company, skill_categories, skill_categories_name, skills_subcategories, skills_subcategories_name, naics2, naics2_name, naics3, naics3_name, naics4, naics4_name, naics5, naics5_name, naics6, naics6_name

Query Parameters

NameDescription
new_taxonomy_versions
enum		Use new taxonomy versions.
This parameter is optional.
Must be one of: true, false
lot_version
enum		Specify LOT taxonomy version to use.
This parameter is optional.
Default: 7
Must be one of: 6, 7
naics_version
enum		Specify NAICS taxonomy version to use.
This parameter is optional.
Default: naics_std_2022
Must be one of: naics_std_2022, naics_std_2017
area_version
enum		Specify area taxonomy version to use.
This parameter is optional.
Default: lf_area_2025_1
Must be one of: lf_area_2023_2, 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

Response Body

{
  "filter": {
    "company_name": [
      "Zoho Corporation"
    ]
  },
  "rank": {
    "by": "profiles",
    "limit": 5,
    "extra_metrics": [
      "unique_companies"
    ]
  },
  "nested_rank": {
    "by": "significance",
    "limit": 5
  }
}

Code Examples

curl --request POST \
  --url https://api.lightcast.io/global-profiles/rankings/{rankingFacet}/rankings/{nestedRankingFacet} \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{ "filter": { "company_name": [ "Zoho Corporation" ] }, "rank": { "by": "profiles", "limit": 5, "extra_metrics": [ "unique_companies" ] }, "nested_rank": { "by": "significance", "limit": 5 } }'

Response Examples

{
  "data": {
    "ranking": {
      "buckets": [
        {
          "name": "Los Angeles, CA",
          "ranking": {
            "buckets": [
              {
                "name": "Event Planner",
                "profiles": 1,
                "significance": 7.8
              },
              {
                "name": "Real Estate Agent",
                "profiles": 1,
                "significance": 7.8
              },
              {
                "name": "Marketing Specialist (General)",
                "profiles": 1,
                "significance": 7.8
              },
              {
                "name": "Department Manager",
                "profiles": 1,
                "significance": 3.8
              },
              {
                "name": "Owner / Founder",
                "profiles": 1,
                "significance": 1.4
              }
            ],
            "facet": "lot_specialized_occupation_name",
            "limit": 5,
            "rank_by": "significance"
          },
          "significance": 0,
          "unique_companies": 4
        },
        {
          "name": "New York, NY",
          "ranking": {
            "buckets": [
              {
                "name": "Chemical Technician",
                "profiles": 1,
                "significance": 7.8
              },
              {
                "name": "Data Manager",
                "profiles": 1,
                "significance": 7.8
              },
              {
                "name": "English / Language Arts Teacher",
                "profiles": 1,
                "significance": 3.8
              },
              {
                "name": "Executive Assistant",
                "profiles": 1,
                "significance": 2.5
              },
              {
                "name": "Owner / Founder",
                "profiles": 1,
                "significance": 1.4
              }
            ],
            "facet": "lot_specialized_occupation_name",
            "limit": 5,
            "rank_by": "significance"
          },
          "significance": 0,
          "unique_companies": 1
        },
        {
          "name": "[Unknown City], ",
          "ranking": {
            "buckets": [
              {
                "name": ".NET Developer / Engineer",
                "profiles": 1,
                "significance": 12.2
              },
              {
                "name": "Software Developer / Engineer",
                "profiles": 1,
                "significance": 6
              },
              {
                "name": "Clinical Supervisor / Manager",
                "profiles": 1,
                "significance": 3.9
              },
              {
                "name": "Project Manager (General)",
                "profiles": 1,
                "significance": 3.9
              }
            ],
            "facet": "lot_specialized_occupation_name",
            "limit": 5,
            "rank_by": "significance"
          },
          "significance": 0,
          "unique_companies": 6
        },
        {
          "name": "Kansas City, MO",
          "ranking": {
            "buckets": [
              {
                "name": "Systems Engineer",
                "profiles": 1,
                "significance": 49.2
              },
              {
                "name": "Distribution Manager",
                "profiles": 1,
                "significance": 49.2
              }
            ],
            "facet": "lot_specialized_occupation_name",
            "limit": 5,
            "rank_by": "significance"
          },
          "significance": 0,
          "unique_companies": 3
        },
        {
          "name": "[Unknown City], NY",
          "ranking": {
            "buckets": [
              {
                "name": "Director of Sales",
                "profiles": 1,
                "significance": 49.2
              },
              {
                "name": "Producer",
                "profiles": 1,
                "significance": 16.1
              }
            ],
            "facet": "lot_specialized_occupation_name",
            "limit": 5,
            "rank_by": "significance"
          },
          "significance": 0,
          "unique_companies": 0
        }
      ],
      "facet": "city_name",
      "limit": 5,
      "rank_by": "significance"
    },
    "totals": {
      "unique_companies": 79
    }
  }
}

Updated 11 days ago

Did this page help you?

Updated 11 days ago

Did this page help you?