Typeaheads
Autocomplete endpoints for companies, schools, investors, locations, and skills — plus job-title synonym expansion and preset metro regions.
Typeahead endpoints power autocomplete UIs and, just as importantly, make
sure the values you send to search filters are ones Fiber can resolve cleanly.
All of them support partial inputs with ranked results, so a few keystrokes is
enough. All four are POST and share a 240 requests/minute rate limit.
| Operation | Path | Resolves | Credits |
|---|---|---|---|
companyTypeahead | /v1/typeahead/company | Companies, schools/universities, investors by name | 1 (free if no matches) |
locationTypeahead | /v1/typeahead/location | Cities and ZIP codes → coordinates + preset metro regions | 1 |
skillsTypeahead | /v1/typeahead/skills | Professional skills from prefixes | Free |
jobTitleRewrite | /v1/typeahead/job-title | A title expanded into synonyms/variations | 1 |
Each operation name links to its full schema reference.
Company typeahead and its modes
The company, school & investor autocomplete searches companies, schools, and
investors by name. Send the partial name as startsWith; the optional
orgType filter picks what you want:
- omit it to search all organization types,
school: only schools/universities,investor: only VC firms/funds/angels.
Each suggestion returns the canonical name, all known names, domains, and the LinkedIn slug and org ID, everything needed to pin the exact organization in a follow-up search or filter. A call that finds nothing is free.
Use the school mode whenever you're filling education-related filters.
People-search education filters expect school names that resolve to known
institutions — free-typing "MIT" into a filter can miss or mis-resolve, but
picking the canonical entity from school typeahead guarantees a clean match.
The same logic applies to investor names before using funding-side filters.
Company typeahead results are relevance-ranked and capped at 20 suggestions per call; a typeahead is about finding the single right value, not filtering a list.
Location typeahead
Send a query of up to 100 characters: a city name or ZIP/postal code,
complete ("New York") or partial ("san fr"). Neighborhoods, street addresses,
states, and countries are not supported. Two things come back:
data— candidate places with their latitude/longitude (plus name and address). Feed a point into theradial-distancelocation strategy to search within N miles or kilometers of it.presetRegions— matching metro-area presets (SF Bay Area, Greater New York, and other major metros), each with aslug, geometry, and its major cities. Pass the slug to thepreset-regionlocation strategy and you cover the whole metro without assembling city lists yourself.
A location query answered only by preset regions is free.
Skills typeahead
Search professional skills by prefix: query in, up to 20 ranked
suggestions out, each a { skill, rank } pair with rank 1 the best match.
Use it to build skill pickers, or to normalize free-text skill lists before
applying skills filters in people search. It's free, so wiring it to
every keystroke costs nothing.
Job title synonym expansion
Job-title synonym expansion takes one job title (up to 200 characters) and
expands it into synonyms and related variations ("SDR" → a family of
sales-development titles). Set
limit to control how many suggestions come back (1–50, default 10); the
response is a flat list of titles, with your original title left out. Feed
the expanded set into job-title filters to improve yield instead of matching
a single exact string.
Advice
- Always resolve through typeaheads when building UIs. Values picked from typeahead resolve deterministically in filters; free text invites misses.
- Use school/investor modes for education and funding flows (see the callout above).
- Expand titles rather than guessing variants. The synonym endpoint captures naming variants you'd never enumerate by hand.
- Use the free reference lists for fixed vocabularies. Metros, regions,
states, technologies, tags, languages, and NAICS codes each have a free
list under
/v1/enums/that you can load once and cache instead of calling a typeahead per keystroke. - Mind which calls are billed. Skills typeahead is free at any frequency; the other three cost a credit per call, so debounce them behind a short pause rather than firing per keystroke.
Credits
Skills typeahead is free. Company, location, and job-title calls are 1
credit each, with two free paths: a company lookup that returns no matches,
and a location lookup answered by preset regions alone. All four share the
240 requests/minute limit, and chargeInfo on every response is the
authoritative record of what you paid. See Billing & credits.
Credit amounts are defaults — custom pricing is available for bulk use cases.