---
title: "Suggest values for a free-text search field"
method: GET
path: "/business/prospects/autocomplete"
tags: ["Prospect search"]
---

# Suggest values for a free-text search field

`GET /business/prospects/autocomplete`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/prospects/autocomplete`
- Auth: HTTP basic

Type-ahead vocabulary for the free-text people filters — `company`, `website`, `location`, `region`, `title`, `school`, `skill` — the same suggestions the product's search UI offers. Send the returned `name` verbatim as the filter value; the values are lower-cased exactly as the provider stores them. The enum-backed fields are served in full by GET /prospects/filter-options instead. Only `field=region` rows carry `countries`, listing the countries that region name appears in, likeliest first, so identically named regions can be told apart. Free: no credits, no provider spend beyond the type-ahead call.

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: search.

## Query parameters

- `field` 'company' | 'website' | 'location' | 'region' | 'title' | 'school' | 'skill', required: Which free-text vocabulary to suggest from: `company`, `website`, `location`, `region`, `title`, `school` or `skill` (`region` suggestions also carry the `countries` they appear in).
- `q` string, required: Text fragment to complete (1-100 chars).

## Response `200`

Success

- object
  - `field` 'company' | 'website' | 'location' | 'region' | 'title' | 'school' | 'skill', required: Echo of the requested field.
  - `suggestions` object[], required
    - `name` string, required: The canonical value to send as the filter value.
    - `countries` string[]: Only on `field=region` rows: the countries this region name appears in, likeliest first.

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)