Autocomplete Schools
curl --request GET \
--url https://api.example.com/api/v1/operations/autocomplete/schools \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/operations/autocomplete/schools"
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/schools', 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/schools",
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/schools"
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/schools")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/operations/autocomplete/schools")
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": "school_001",
"name": "Stanford University",
"logo": "https://media.licdn.com/dms/image/C4D0BAQGpkTfVh3vJrQ/company-logo_200_200/0/1631355051949",
"url": "https://www.linkedin.com/school/stanford-university/",
"domain": "stanford.edu",
"domainLtd": "edu",
"website": "https://www.stanford.edu"
},
{
"id": "school_002",
"name": "Stanford Graduate School of Business",
"logo": "https://media.licdn.com/dms/image/C4E0BAQHpBPxGvjLtGQ/company-logo_200_200/0/1625167812432",
"url": "https://www.linkedin.com/school/stanford-gsb/",
"domain": "gsb.stanford.edu",
"domainLtd": "edu",
"website": "https://www.gsb.stanford.edu"
}
],
"totalElements": 15,
"totalPages": 2,
"size": 10,
"number": 0,
"first": true,
"last": false,
"empty": false,
"numberOfElements": 10
}
{
"content": [],
"totalElements": 0,
"totalPages": 0,
"size": 10,
"number": 0,
"first": true,
"last": true,
"empty": true,
"numberOfElements": 0
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
Autocomplete
Autocomplete Schools
Search and retrieve school/university suggestions for education-based lead filtering
GET
/
api
/
v1
/
operations
/
autocomplete
/
schools
Autocomplete Schools
curl --request GET \
--url https://api.example.com/api/v1/operations/autocomplete/schools \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/operations/autocomplete/schools"
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/schools', 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/schools",
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/schools"
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/schools")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/operations/autocomplete/schools")
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": "school_001",
"name": "Stanford University",
"logo": "https://media.licdn.com/dms/image/C4D0BAQGpkTfVh3vJrQ/company-logo_200_200/0/1631355051949",
"url": "https://www.linkedin.com/school/stanford-university/",
"domain": "stanford.edu",
"domainLtd": "edu",
"website": "https://www.stanford.edu"
},
{
"id": "school_002",
"name": "Stanford Graduate School of Business",
"logo": "https://media.licdn.com/dms/image/C4E0BAQHpBPxGvjLtGQ/company-logo_200_200/0/1625167812432",
"url": "https://www.linkedin.com/school/stanford-gsb/",
"domain": "gsb.stanford.edu",
"domainLtd": "edu",
"website": "https://www.gsb.stanford.edu"
}
],
"totalElements": 15,
"totalPages": 2,
"size": 10,
"number": 0,
"first": true,
"last": false,
"empty": false,
"numberOfElements": 10
}
{
"content": [],
"totalElements": 0,
"totalPages": 0,
"size": 10,
"number": 0,
"first": true,
"last": true,
"empty": true,
"numberOfElements": 0
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
Provides autocomplete suggestions for schools and universities. This endpoint powers the autocomplete functionality in education filter dropdowns, helping users discover valid school names when filtering leads by educational background.
Authentication
This endpoint requires authentication. The user must be signed in to access autocomplete data.This endpoint proxies requests to the company search metadata API with a
school filter. Results are cached for 7 days to improve performance.
Request
string
Search query to filter school names. Returns schools that match this text.
Example:
"Stanford", "MIT", "Harvard"integer
default:"10"
Number of results to return per page. Maximum recommended is 100.
integer
default:"0"
Zero-based page number for pagination.
Response
Returns a paginated list of school items matching the search criteria.SchoolItem[]
Array of school items matching the query.
Show SchoolItem properties
Show SchoolItem properties
string
required
Unique identifier for the school.
string
required
The school/university name to display and use in filters.
string
URL to the school’s logo image. Can be null.
string
LinkedIn or external profile URL for the school. Can be null.
string
Primary domain associated with the school. Can be null.
string
Top-level domain variation. Can be null.
string
Official website URL for the school. Can be null.
integer
Total number of matching schools 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": "school_001",
"name": "Stanford University",
"logo": "https://media.licdn.com/dms/image/C4D0BAQGpkTfVh3vJrQ/company-logo_200_200/0/1631355051949",
"url": "https://www.linkedin.com/school/stanford-university/",
"domain": "stanford.edu",
"domainLtd": "edu",
"website": "https://www.stanford.edu"
},
{
"id": "school_002",
"name": "Stanford Graduate School of Business",
"logo": "https://media.licdn.com/dms/image/C4E0BAQHpBPxGvjLtGQ/company-logo_200_200/0/1625167812432",
"url": "https://www.linkedin.com/school/stanford-gsb/",
"domain": "gsb.stanford.edu",
"domainLtd": "edu",
"website": "https://www.gsb.stanford.edu"
}
],
"totalElements": 15,
"totalPages": 2,
"size": 10,
"number": 0,
"first": true,
"last": false,
"empty": false,
"numberOfElements": 10
}
{
"content": [],
"totalElements": 0,
"totalPages": 0,
"size": 10,
"number": 0,
"first": true,
"last": true,
"empty": true,
"numberOfElements": 0
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred"
}
}
Usage Examples
Search for Stanford schools
curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/schools?search=stanford&size=10" \
-H "Authorization: Bearer YOUR_TOKEN"
Get Ivy League schools
curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/schools?search=harvard" \
-H "Authorization: Bearer YOUR_TOKEN"
Paginate through results
curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/schools?search=university&page=1&size=20" \
-H "Authorization: Bearer YOUR_TOKEN"
Search without filter (browse all)
curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/schools?size=25" \
-H "Authorization: Bearer YOUR_TOKEN"
Notes
- Results are cached for 7 days to improve performance. The cache is shared across all users.
- Use the
searchparameter for type-ahead/autocomplete functionality - it filters results that match the search text. - The default page size is 10 items. Increase the
sizeparameter for more results per request. - Schools include universities, colleges, business schools, and other educational institutions.
- The
logofield provides LinkedIn-hosted images when available.