> ## Documentation index
> Fetch the complete documentation index at: https://rankfield.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Suggest

> Get the autocomplete suggestions Bing, DuckDuckGo and Yahoo show for a keyword, one at a time or for up to 10,000 keywords in a job.

Each engine has its own path and the same contract: a GET for one keyword, answered at once, and jobs for keyword lists. Any Rankfield API key works, with no sign-up step.

| Engine | Base path |
|---|---|
| Bing | `/v1/bing/suggest` |
| DuckDuckGo | `/v1/ddg/suggest` |
| Yahoo | `/v1/yahoo/search-predictions` |

Job pages use Bing in their examples; replace the base path to use another engine.

## Pages

- [Get Bing suggestions](/docs/suggest/get-bing-suggestions): Get the autocomplete suggestions Bing shows for a keyword, in one of ten markets, as a JSON list.
- [Get DuckDuckGo suggestions](/docs/suggest/get-duckduckgo-suggestions): Get the autocomplete suggestions DuckDuckGo shows for a keyword, as a JSON list with the time they were collected.
- [Get Yahoo Search Predictions](/docs/suggest/get-yahoo-search-predictions): Get the search predictions Yahoo shows for a keyword, as a JSON list with the time they were collected.
- [Start a suggest job](/docs/suggest/start-a-job): Collect suggestions for up to 10,000 keywords in one job, with a delivery deadline of 6, 60 or 300 seconds.
- [Get a suggest job](/docs/suggest/get-a-job): Check a suggest job's status and how many of its keywords are done, succeeded and failed.
- [Get suggest job results](/docs/suggest/get-results): Read a suggest job's keywords as they finish, each with its engine answer, and page through them with a cursor.
- [Cancel a suggest job](/docs/suggest/cancel-a-job): Stop a running suggest job. Keywords already finished stay readable; the rest end with status 499.
- [Get usage and capacity](/docs/suggest/get-usage-and-capacity): See how many keywords your key has used today on a suggest engine, its jobs and requests by status, and the engine's delivery tiers.
:::