Check a site's DuckDuckGo rank
Check where a site ranks in DuckDuckGo's web results for a keyword, up to 200 results deep.
Headers
Get your API keyAPI key (`sfk_...`)
The search to rank in, e.g. `marathon training plan`.
min 1 chars · max 500 chars
The site to find, e.g. `halhigdon.com`. A URL is accepted and reduced to its host; `www.` and subdomains match too.
max 253 chars · pattern: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$
How many results to check, 10 to 200. Default: 100.
≥ 10 · ≤ 200
Only results from the past `day`, `week`, `month` or `year`. Default: any time.
one of: day, week, month, year
Two-letter country code of the results' region, e.g. `GB` or `DE`. Default: `US`.
pattern: ^[A-Z]{2}$
Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the region's first language.
pattern: ^[a-z]{2}$
Endpoint-specific response payload.
`found` when the site ranks within the depth checked; `not_found` when it does not.
one of: found, not_found
The query that was searched.
The site that was looked for.
DuckDuckGo's region code the results are for, e.g. `us-en`.
The site's best position, from 1; null when it was not found.
The site's best-ranked result; null when it was not found.
Rank in the results, from 1.
Result title.
The page the result links to.
The address as DuckDuckGo shows it.
Text under the title.
Every position of the site on the pages checked.
Results checked before the answer was settled.
Result pages read.
Whether DuckDuckGo ran out of results before the depth.
True when a results page could not be read in time, so fewer results than the depth were checked; `checkedResults` says how many were.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/duckduckgo/rank?query=marathon%20training%20plan&domain=halhigdon.com" \
-H "x-api-key: YOUR_API_KEY"Responses
Where a site ranks for a query on DuckDuckGo.