Typeaheads
Autocomplete endpoints for companies, schools, investors, locations, and skills — plus job-title synonym expansion and preset metro regions.
Typeaheads
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
companyTypeahead searches companies, schools, and investors by name. Send
the partial name as startsWith; the optional orgType filter picks what
you want:
- omit it — 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.
Results are relevance-ranked — 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.
If place lookup is temporarily unavailable but preset regions match your query, you still get the regions — and the call 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
jobTitleRewrite expands one job title (up to 200 characters) 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.
- 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.