> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/duckduckgo/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/duckduckgo/search.mdx>

---

# DuckDuckGo Search API

DuckDuckGo's web results for a query, in any region, page by page.

`GET /v1/duckduckgo/search` returns `data.results[]`, `data.ads[]`, `data.pageNumber` and `data.page`. A result carries `position`, `title`, `url`, `displayUrl` and `snippet`; an ad carries `title`, `domain`, `displayUrl` and `snippet`. `query` is up to 500 characters and search operators such as `site:` work. `country` and `language` pick the region (default US English); `time` takes `day`, `week`, `month` or `year`. Pass `page.nextCursor` as `cursor` for the next page: page 1 holds about 10 results, later pages about 15.

## Request

- **Endpoint:** `GET /v1/duckduckgo/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by keyword
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/duckduckgo/search/get)
- **Platform page:** [/platforms/duckduckgo](https://www.socialfetch.dev/platforms/duckduckgo)

## FAQ

### Do positions continue across pages?

Yes. Page 2 starts where page 1 ended. When DuckDuckGo repeats a result from an earlier page, it is dropped and the positions stay consecutive.

### Are ads counted in positions?

No. Ads are returned in ads and positions count only the organic results.

### How deep can I page?

As long as DuckDuckGo has results: page.hasMore turns false on the last page. For where one site ranks, GET /v1/duckduckgo/rank reads up to 200 results in one request.

### Can I search without a region?

The default is DuckDuckGo's US English region. Pass country, and language for a country with several, to search another one.

### How much does a page of results cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
