Autocomplete Classifications
curl --request GET \
--url https://api.example.com/api/v1/operations/autocomplete/classifications \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/operations/autocomplete/classifications"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/operations/autocomplete/classifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/operations/autocomplete/classifications",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/operations/autocomplete/classifications"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/operations/autocomplete/classifications")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/operations/autocomplete/classifications")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
}
{
"content": [
{
"id": "ind_001",
"key": "INDUSTRY",
"value": "Software Development",
"index": 0,
"metadata": null
},
{
"id": "ind_002",
"key": "INDUSTRY",
"value": "Software as a Service (SaaS)",
"index": 1,
"metadata": null
}
],
"totalElements": 2,
"totalPages": 1,
"size": 25,
"number": 0,
"first": true,
"last": true,
"empty": false,
"numberOfElements": 2
}
{
"content": [],
"totalElements": 0,
"totalPages": 0,
"size": 25,
"number": 0,
"first": true,
"last": true,
"empty": true,
"numberOfElements": 0
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Missing required parameter: key"
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
Autocomplete
Autocomplete Classifications
Search and retrieve classification values for filtering leads by skills, industries, languages, and more
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>'import requests
url = "https://api.example.com/api/v1/operations/autocomplete/classifications"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/operations/autocomplete/classifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/operations/autocomplete/classifications",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/operations/autocomplete/classifications"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/operations/autocomplete/classifications")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/operations/autocomplete/classifications")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
}
{
"content": [
{
"id": "ind_001",
"key": "INDUSTRY",
"value": "Software Development",
"index": 0,
"metadata": null
},
{
"id": "ind_002",
"key": "INDUSTRY",
"value": "Software as a Service (SaaS)",
"index": 1,
"metadata": null
}
],
"totalElements": 2,
"totalPages": 1,
"size": 25,
"number": 0,
"first": true,
"last": true,
"empty": false,
"numberOfElements": 2
}
{
"content": [],
"totalElements": 0,
"totalPages": 0,
"size": 25,
"number": 0,
"first": true,
"last": true,
"empty": true,
"numberOfElements": 0
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Missing required parameter: key"
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
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
string
default:"PERSON"
The entity group to search classifications for.Allowed values:
PERSON, COMPANYstring
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 keywordsDEGREE- 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 keywordsTECHNOLOGY- Technologies and tools (e.g., “React”, “AWS”)
string
Search query to filter classification values. Returns classifications that
match this text.
integer
default:"25"
Number of results to return per page.
integer
default:"0"
Zero-based page number for pagination.
Response
Returns a paginated list of classification items matching the search criteria.ClassificationItem[]
Array of classification items matching the query.
Show ClassificationItem properties
Show ClassificationItem properties
string
Unique identifier for the classification. Can be null.
string
required
The classification type (matches the
key query parameter).string
required
The classification value to display and use in filters.
integer
required
Sort index for ordering results.
integer
Total number of matching classifications across all pages.
integer
Total number of pages available.
integer
Number of items per page.
integer
Current page number (zero-based).
boolean
Whether this is the first page.
boolean
Whether this is the last page.
boolean
Whether the result set is empty.
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
}
{
"content": [
{
"id": "ind_001",
"key": "INDUSTRY",
"value": "Software Development",
"index": 0,
"metadata": null
},
{
"id": "ind_002",
"key": "INDUSTRY",
"value": "Software as a Service (SaaS)",
"index": 1,
"metadata": null
}
],
"totalElements": 2,
"totalPages": 1,
"size": 25,
"number": 0,
"first": true,
"last": true,
"empty": false,
"numberOfElements": 2
}
{
"content": [],
"totalElements": 0,
"totalPages": 0,
"size": 25,
"number": 0,
"first": true,
"last": true,
"empty": true,
"numberOfElements": 0
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Missing required parameter: key"
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
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
groupparameter affects which classifications are returned -PERSONreturns people-related classifications whileCOMPANYreturns company-specific ones. - Use the
valueparameter for type-ahead/autocomplete functionality - it filters results that match the search text. - The
keyparameter is required and determines the type of classifications returned.