DuckDuckGo API
DuckDuckGo is a privacy-focused web search engine. search returns up to 50 organic results for a query with title, link, displayed URL, snippet and site icon.
Filter by region with country and language, and by recency with time_window (day, week, month or year). Only plain search words are accepted: exact-phrase quotes and operators such as site: are rejected before any charge.
Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each DuckDuckGo action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Search DuckDuckGo by keyword and get up to 50 results with rank, title, link, displayed URL, snippet and site icon. | $0.56 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each DuckDuckGo action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and features of the official site are not part of the EveryInfra API unless this page lists them.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search DuckDuckGo by | keyword | country, language, page, time_window | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | rank · title · url · displayed_url · text · favicon_url · platform |
What do the DuckDuckGo search parameters mean?
Search DuckDuckGo by keyword and get up to 50 results with rank, title, link, displayed URL, snippet and site icon. Filter by region, language and recency (day, week, month or year). Plain search words only: quoted phrases and site: are rejected before any charge.
keywordRequired- The DuckDuckGo search words, up to 500 characters. Exact-phrase quotes and operators such as site: are rejected before any charge.
countryOptional- A two-letter country code such as
us,gb,deorjpthat sets DuckDuckGo's search region. Leave it out, or use a country DuckDuckGo has no region for, to search all regions.DuckDuckGo Help: Setting the Search Region with URL Parameters — DuckDuckGo's help page says the search region is set with the kl parameter, written as region-language (such as us-en or de-de), next to settings such as safe search. The source confirms only that DuckDuckGo separates results by region; this API's `country` and `language` are defined by EveryInfra and combined into that region setting; a two-letter country code is mapped to DuckDuckGo's region token (gb becomes uk-en), and a country missing from its region list searches all regions. The source says nothing about result counts or date filters. · Checked languageOptional- A two-letter language code that picks the language version of a region that has several, such as
enorfrfor Canada; otherwise it has no effect. pageOptional- Which page of results to return, starting at 1, with
limitresults per page (up to 20 pages). time_windowOptional- Only return pages from a recent period:
day,week,monthoryear. Leave it out for no date limit.
How to use the DuckDuckGo API
- 01Choose a platform action from the public catalog.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Read the result from the response. For an asynchronous action, poll the returned job ID.
- 04Store the response fields that your application needs.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"duckduckgo","action":"search","params":{"keyword":"<keyword>"}}'
DuckDuckGo API questions
What can I retrieve with the DuckDuckGo API?
Set platform to duckduckgo. The current catalog lists search. These action names identify different DuckDuckGo objects or views; they are not interchangeable search modes.
Which input starts the DuckDuckGo search request?
The DuckDuckGo search words, up to 500 characters. Exact-phrase quotes and operators such as site: are rejected before any charge. Send it as keyword inside params.
Which fields can DuckDuckGo search return?
Its declared schema includes rank, title, displayed_url, and text. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every DuckDuckGo action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.