DuckDuckGo hub

DuckDuckGo Rank Checker API

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

GET /v1/duckduckgo/rank

1 credit Failed requests are free

About this endpoint

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.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

DuckDuckGo Rank Checker API 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.