DuckDuckGo Autocomplete Scraper

Extracts search autocomplete suggestions from DuckDuckGo's ac.duckduckgo.com API for any query prefix.

What this Actor collects

The Actor converts DuckDuckGo autocomplete responses into one clean JSON record per suggestion, with its rank, seed query, locale, word and character counts, exact-match flag, search URL, API URL, and retrieval metadata.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 19-field dataset schema.
• Omits optional fields when the source does not expose a value instead of writing nulls or fabricated placeholders.

Use cases

• Keyword discovery
• Content and SEO research
• Search-demand exploration

Input

Provide input in JSON. Fields marked required must be supplied. The Default / example column shows a schema default when one exists; otherwise it shows a documented prefill or fixture value.

Field	Type	Required	Default / example	Description
query	string	Yes	"artificial"	The search query prefix to get autocomplete suggestions for.
maxResults	integer	No	10	Maximum number of suggestions to return.
region	string	No	"us-en"	Region code (e.g. 'us-en', 'uk-en', 'de-de').
maxRequestRetries	integer	No	2	Retries for transient rate limits and server failures.
requestTimeoutSecs	integer	No	30	Maximum time in seconds for each autocomplete request.
headless	boolean	No	true	Run Firefox without a visible window.
proxyConfiguration	object	No	{"useApifyProxy":true}	Proxy settings for the scraper.

Example input

{
  "query": "artificial",
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "maxResults": 10,
  "region": "us-en",
  "maxRequestRetries": 2,
  "requestTimeoutSecs": 30,
  "headless": true
}

Output

The default dataset contains one item per autocomplete suggestion. The following are the most useful fields; locale-derived fields depend on the requested region code.

Field	Type	Description
position	integer	Position
suggestion	string	Suggestion
query	string	Query Prefix
region	string	Region
isExactMatch	boolean	Exact Query Match
wordCount	integer	Word Count
searchUrl	string	Suggestion Search URL
scrapedAt	string	Scraped At
type	string	Record Type
title	string	Title
description	string	Description
searchQuery	string	Search Query
resultType	string	Result Type
country	string	Country
language	string	Language
market	string	Market

Example dataset item

This compact example is taken from local Actor storage. Long text and nested collections are shortened for documentation only.

{
  "position": 1,
  "suggestion": "artificial intelligence",
  "query": "artificial",
  "region": "us-en",
  "isExactMatch": false,
  "wordCount": 2,
  "searchUrl": "https://duckduckgo.com/?q=artificial+intelligence&kl=us-en",
  "scrapedAt": "2026-07-23T16:28:20.115Z",
  "type": "autocomplete-suggestion",
  "title": "artificial intelligence",
  "description": "DuckDuckGo autocomplete suggestion for \"artificial\".",
  "searchQuery": "artificial"
}

Related Actors

• Duck.ai Guest Answers Scraper
• DuckDuckGo Bangs Directory Scraper
• DuckDuckGo Images Scraper