Skip to main content
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>'
{
  "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
}
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

​
search
string
Search query to filter school names. Returns schools that match this text. Example: "Stanford", "MIT", "Harvard"
​
size
integer
default:"10"
Number of results to return per page. Maximum recommended is 100.
​
page
integer
default:"0"
Zero-based page number for pagination.

​
Response

Returns a paginated list of school items matching the search criteria.
​
content
SchoolItem[]
Array of school items matching the query.
​
totalElements
integer
Total number of matching schools 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": "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
}

​
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 search parameter for type-ahead/autocomplete functionality - it filters results that match the search text.
  • The default page size is 10 items. Increase the size parameter for more results per request.
  • Schools include universities, colleges, business schools, and other educational institutions.
  • The logo field provides LinkedIn-hosted images when available.