Search DuckDuckGo Images
Search DuckDuckGo Images by keyword and region, filtered by size, colour, type, layout, licence and date, with each image's size and source page.
Headers
Get your API keyAPI key (`sfk_...`)
What to search images for, e.g. `red panda`.
min 1 chars · max 500 chars
Only images first seen in the past `day`, `week`, `month` or `year`. Default: any time.
one of: day, week, month, year
`small`, `medium`, `large` or `wallpaper`. Default: any size.
one of: small, medium, large, wallpaper
`color` (colour images only), `monochrome`, or a main colour such as `red` or `teal`. Default: any.
one of: color, monochrome, red, orange, yellow, green, blue, purple, pink, brown, black, gray, teal, white
`photo`, `clipart`, `gif` (animated), `transparent` or `line` (line drawings). Default: any type.
one of: photo, clipart, gif, transparent, line
`square`, `tall` or `wide`. Default: any layout.
one of: square, tall, wide
Usage rights: `any` (any Creative Commons licence), `public` (public domain), `share`, `share_commercially`, `modify` or `modify_commercially`. Default: any licence, including none.
one of: any, public, share, share_commercially, modify, modify_commercially
`strict`, `moderate` or `off`. Default: `moderate`.
one of: strict, moderate, off
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 4096 chars
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.
Always `found`: no match is an empty list.
one of: found, not_found
The query that was searched.
DuckDuckGo's region code the results are for, e.g. `us-en`.
Images, most relevant first; about 100 a page. An image already returned on an earlier page is left out.
Title of the page the image is on.
Full-size image URL.
Thumbnail URL.
URL of the page the image is on.
Width in pixels.
Height in pixels.
File format where known, e.g. `jpeg` or `png`.
When the image was first found, ISO 8601 UTC.
Related searches DuckDuckGo suggests, e.g. `Eiffel Tower Front View`; first page only.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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/images?query=eiffel%20tower" \
-H "x-api-key: YOUR_API_KEY"Responses
DuckDuckGo image results for a query.