DuckDuckGo Search API
DuckDuckGo's web results for a query, in any region, page by page.
GET /v1/duckduckgo/search1 credit Failed requests are free
About this endpoint
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.
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.
Example response
A 200 response. Live responses have the same shape with current data.
DuckDuckGo Search API 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.