/recency

Group filtered profile metrics by year, based on profile recency (when they were last updated).

`POST /recency`

Query Parameters

Name	Description
`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": {
    "last_updated": {
      "start": 2020
    },
    "skills_name": {
      "include": [
        "C++ (Programming Language)"
      ]
    }
  },
  "metrics": [
    "profiles"
  ]
}

Code Examples

curl --request POST \
  --url https://api.lightcast.io/global-profiles/recency \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{ "filter": { "last_updated": { "start": 2020 }, "skills_name": { "include": [ "C++ (Programming Language)" ] } }, "metrics": [ "profiles" ] }'

Response Examples

{
  "data": {
    "recency": {
      "profiles": [
        2855,
        3390,
        2937,
        20650,
        21280,
        243016
      ],
      "year": [
        "2020",
        "2021",
        "2022",
        "2023",
        "2024",
        "2025"
      ]
    },
    "totals": {
      "profiles": 294128
    }
  }
}