# DuckDuckGo search: `POST /v1/duckduckgo/search`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/duckduckgo-search

One page of DuckDuckGo web results: 10 on page 1, about 15 on later
pages.

Each result has its position, title, destination `link`, the address
DuckDuckGo displays and the snippet. Ads are left out. `region` is
DuckDuckGo's region code (`us-en`, `de-de`, `wt-wt` for none), with
`safe_search` and a `time` filter (past day, week, month or year).
`search_information.has_more` says whether another page follows. An empty
page is not billed; a failed call is 503 with
`Retry-After` and is not billed.

Request body (JSON):

- `q` (string; required; min length 1, max length 500): Search query.
- `region` (string | null; optional; pattern ^[a-z]{2}-[a-z]{2,3}$): DuckDuckGo region: 'us-en', 'uk-en', 'de-de', 'fr-fr', 'jp-jp' … ('wt-wt' or empty for no region).
- `safe_search` (string | null; optional; one of strict, moderate, off): Safe search: 'strict', 'moderate' (DuckDuckGo's default) or 'off'.
- `time` (string | null; optional; one of d, w, m, y): Only pages from the past day (d), week (w), month (m) or year (y).
- `page` (integer; optional; default 1; min 1, max 20): Result page.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
