Get search suggestions for a partial query
The completions DuckDuckGo’s search box suggests for a partial query, in DuckDuckGo’s order — useful for keyword research and query expansion. Takes a region but no safe search or time range; sending either is a 400. Billing: one request.
/suggestions Answers https://api.fetchlayer.dev/duckduckgo/suggestions Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
query string required The partial query to complete (1–500 characters).
region string optional Region code: us-en, uk-en, de-de, fr-fr, es-es, it-it, jp-jp, in-en, au-en, ca-en, br-pt and 52 more (64 codes, DuckDuckGo’s own list), or wt-wt for no region. Results and rankings differ by region. (default: us-en)
format string optional json or markdown. (default: json)
timeoutMs number optional Time limit for each page read, in milliseconds (1000–120000).
Response Fields
suggestions
Get search suggestions for a partial query
resultType string search, rank-check, instant-answer, suggestions, news, videos or images.
requestedUrl string The DuckDuckGo page this result corresponds to.
notes string[] Caveats about this particular result — a list that may be incomplete, a depth DuckDuckGo could not reach, a later page that could not be read. Empty when there are none. Read it on every call.
transport string The source this data came from. Always "duckduckgo".
scrapedAt string ISO 8601 timestamp of when the data was collected.
query string The partial query.
region string The region the suggestions are for.
suggestions string[] The completions, in DuckDuckGo’s order.
pagesScraped number Always 1.
Request
curl -X POST "https://api.fetchlayer.dev/duckduckgo/suggestions" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"query":"fetchla"}'Response
{
"resultType": "suggestions",
"requestedUrl": "https://duckduckgo.com/?q=fetchla&kl=us-en",
"scrapedAt": "2026-09-15T19:47:52.217Z",
"transport": "duckduckgo",
"notes": [],
"query": "fetchla",
"region": "us-en",
"suggestions": [
"fetch lands",
"fetchland",
"fetch lands mtg",
"fetchlab",
"fetchlands scryfall",
"fetch land magic",
"fetchland set",
"fetchlater"
],
"pagesScraped": 1
}