DuckDuckGo Images API
DuckDuckGo image results for a query, in any region.
GET /v1/duckduckgo/images1 credit Failed requests are free
About this endpoint
GET /v1/duckduckgo/images returns data.images[], about 100 a page, each with title, imageUrl, thumbnail, pageUrl, width, height, format and firstSeenAt, plus DuckDuckGo's relatedSearches on the first page. Filter with size, color, type, layout, license and time, and set safeSearch to strict, moderate or off. country and language pick the region. Pass page.nextCursor as cursor for the next page.
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 Images API FAQ
Can I find images I'm allowed to reuse?
Yes. license narrows the results by usage rights: public for public domain, share or share_commercially, modify or modify_commercially, or any for any Creative Commons licence. Check the licence on the image's own page before you use it.
Why did a filtered search come back empty?
Filters combine, so several at once can leave nothing: past year, large and share-licensed together found no red panda photos when we tried. Drop a filter and search again.
How much does an image search 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.