Company search

Suggest values for company and location filters

Resolves free-text input to canonical company-filter values; two characters minimum. field=company returns company names with their domain when known — send name to nameLike, or domain to domains; add orgType=investor to search investors instead, whose domain is the value the investors filter takes. field=location returns fully qualified place names ("Dallas, Texas, United States") which are exactly what the headquartersCity filter takes — the qualification is what lets the geocoder tell six same-named cities apart, so send the whole string. Note that officeLocationsV2 is a different filter and takes country apiCodes from GET /companies/filter-options, not these place names. Same vocabulary as the product's type-ahead; free.

Errors:

  • 422 VALIDATION_FAILED — The request failed the declared schema; param names the offending key and message quotes the rule it broke.
  • 429 RATE_LIMITED — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.
  • 500 UNEXPECTED_ERROR — The request failed inside the service; nothing was billed and the request_id identifies the failure.

Requires one of the following token scopes: companies.

get/business/companies/autocomplete

Request

  • Base URL: https://api.tryfuse.ai/api/v1
  • URL: https://api.tryfuse.ai/api/v1/business/companies/autocomplete
  • Auth: HTTP basic

Query parameters

field'company' | 'location' required

company suggests company names (each with its domain when known); location suggests fully qualified place names (e.g. Dallas, Texas, United States) to send as headquartersCity values.

qstring required

Text fragment to complete (2-200 chars).

orgType'investor'

investor narrows field=company to investors, for the investors filter; not allowed with field=location.

Response

Success

field'company' | 'location' required

Echo of the requested field.

Changes

No recorded changes to this operation across all 1 revision of this API.