DuckDuckGo hub

DuckDuckGo Images API

DuckDuckGo image results for a query, in any region.

GET /v1/duckduckgo/images

1 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.

Request
cURL

Example response

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

Request
JSON

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.