Skip to main content
GET
/
api
/
v1
/
operations
/
autocomplete
/
classifications
Autocomplete Classifications
curl --request GET \
  --url https://api.example.com/api/v1/operations/autocomplete/classifications \
  --header 'Authorization: Bearer <token>'
{
  "content": [
    {
      "id": "skill_001",
      "key": "SKILL",
      "value": "Python",
      "index": 0,
      "metadata": {
        "category": "Programming Languages"
      }
    },
    {
      "id": "skill_002",
      "key": "SKILL",
      "value": "Python Django",
      "index": 1,
      "metadata": {
        "category": "Web Frameworks"
      }
    },
    {
      "id": "skill_003",
      "key": "SKILL",
      "value": "Python Flask",
      "index": 2,
      "metadata": {
        "category": "Web Frameworks"
      }
    }
  ],
  "totalElements": 45,
  "totalPages": 2,
  "size": 25,
  "number": 0,
  "first": true,
  "last": false,
  "empty": false,
  "numberOfElements": 25
}
Provides autocomplete suggestions for classification-based filters used in lead search. This endpoint powers the autocomplete functionality in filter dropdowns, helping users discover valid classification values for skills, headlines, degrees, fields of study, languages, industries, keywords, and technologies.

​
Authentication

This endpoint requires authentication. The user must be signed in to access autocomplete data.
This endpoint proxies requests to the Lance classification API. Results are cached for 7 days to improve performance.

​
Request

​
group
string
default:"PERSON"
The entity group to search classifications for.Allowed values: PERSON, COMPANY
​
key
string
required
The classification type to search. Determines which category of values to return.Allowed values:
  • SKILL - Professional skills (e.g., “Python”, “Project Management”)
  • HEADLINE - LinkedIn headline keywords
  • DEGREE - Academic degrees (e.g., “Bachelor’s”, “MBA”)
  • FIELD_OF_STUDY - Academic fields (e.g., “Computer Science”, “Business”)
  • LANGUAGE - Spoken languages (e.g., “English”, “German”)
  • INDUSTRY - Industry classifications (e.g., “Software”, “Finance”)
  • KEYWORD - General keywords
  • TECHNOLOGY - Technologies and tools (e.g., “React”, “AWS”)
​
value
string
Search query to filter classification values. Returns classifications that match this text.
​
size
integer
default:"25"
Number of results to return per page.
​
page
integer
default:"0"
Zero-based page number for pagination.

​
Response

Returns a paginated list of classification items matching the search criteria.
​
content
ClassificationItem[]
Array of classification items matching the query.
​
totalElements
integer
Total number of matching classifications across all pages.
​
totalPages
integer
Total number of pages available.
​
size
integer
Number of items per page.
​
number
integer
Current page number (zero-based).
​
first
boolean
Whether this is the first page.
​
last
boolean
Whether this is the last page.
​
empty
boolean
Whether the result set is empty.
​
numberOfElements
integer
Number of elements in the current page.

​
Response Examples

{
  "content": [
    {
      "id": "skill_001",
      "key": "SKILL",
      "value": "Python",
      "index": 0,
      "metadata": {
        "category": "Programming Languages"
      }
    },
    {
      "id": "skill_002",
      "key": "SKILL",
      "value": "Python Django",
      "index": 1,
      "metadata": {
        "category": "Web Frameworks"
      }
    },
    {
      "id": "skill_003",
      "key": "SKILL",
      "value": "Python Flask",
      "index": 2,
      "metadata": {
        "category": "Web Frameworks"
      }
    }
  ],
  "totalElements": 45,
  "totalPages": 2,
  "size": 25,
  "number": 0,
  "first": true,
  "last": false,
  "empty": false,
  "numberOfElements": 25
}

​
Usage Examples

​
Search for Python skills

curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/classifications?key=SKILL&value=python&size=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Get all industries

curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/classifications?key=INDUSTRY&group=COMPANY" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Paginate through languages

curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/classifications?key=LANGUAGE&page=1&size=50" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Notes

  • Results are cached for 7 days to improve performance. The cache is shared across all users.
  • The group parameter affects which classifications are returned - PERSON returns people-related classifications while COMPANY returns company-specific ones.
  • Use the value parameter for type-ahead/autocomplete functionality - it filters results that match the search text.
  • The key parameter is required and determines the type of classifications returned.