> **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/rank>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/duckduckgo/rank.mdx>

---

# DuckDuckGo Rank Checker API

Where a site ranks for a query on DuckDuckGo, up to 200 results deep.

`GET /v1/duckduckgo/rank` returns `data.position` (the site's best position, or null), `data.result` (that result), `data.positions` (every position of the site on the page it was found), `data.checkedResults`, `data.pagesChecked`, `data.exhausted` and `data.partial`. `domain` is the site, such as `halhigdon.com`; a URL is accepted and `www.` and subdomains match. `depth` is how many results to read, 10 to 200 (default 100). `country`, `language` and `time` work as on search.

## Request

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

## FAQ

### What if the site does not rank?

The answer is lookupStatus not_found with position null and checkedResults telling how far it looked. exhausted is true when DuckDuckGo ran out of results before the depth.

### How long does a deep check take?

Reading 200 results is about 14 pages and takes 20 to 40 seconds. The check stops as soon as the site is found. If a page can't be read in time, the answer has partial true and checkedResults says how far it got.

### Do subdomains count?

Yes. domain=example.com matches www.example.com and blog.example.com.

### How much does a rank check 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.
