DuckDuckGo

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.

GET/v1/duckduckgo/images
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
11
querystringrequiredquery

What to search images for, e.g. `red panda`.

min 1 chars · max 500 chars

timestringoptionalquery

Only images first seen in the past `day`, `week`, `month` or `year`. Default: any time.

one of: day, week, month, year

sizestringoptionalquery

`small`, `medium`, `large` or `wallpaper`. Default: any size.

one of: small, medium, large, wallpaper

colorstringoptionalquery

`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

typestringoptionalquery

`photo`, `clipart`, `gif` (animated), `transparent` or `line` (line drawings). Default: any type.

one of: photo, clipart, gif, transparent, line

layoutstringoptionalquery

`square`, `tall` or `wide`. Default: any layout.

one of: square, tall, wide

licensestringoptionalquery

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

safeSearchstringoptionalquery

`strict`, `moderate` or `off`. Default: `moderate`.

one of: strict, moderate, off

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 4096 chars

countrystringoptionalquery

Two-letter country code of the results' region, e.g. `GB` or `DE`. Default: `US`.

pattern: ^[A-Z]{2}$

languagestringoptionalquery

Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the region's first language.

pattern: ^[a-z]{2}$

Response fields
24

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no match is an empty list.

one of: found, not_found

dataquery
string

The query that was searched.

dataregion
string

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.

dataimages[]title
string

Title of the page the image is on.

dataimages[]imageUrl
string

Full-size image URL.

dataimages[]thumbnail
stringnullable

Thumbnail URL.

dataimages[]pageUrl
stringnullable

URL of the page the image is on.

dataimages[]width
integernullable

Width in pixels.

dataimages[]height
integernullable

Height in pixels.

dataimages[]format
stringnullable

File format where known, e.g. `jpeg` or `png`.

dataimages[]firstSeenAt
stringnullable

When the image was first found, ISO 8601 UTC.

Related searches DuckDuckGo suggests, e.g. `Eiffel Tower Front View`; first page only.

datarelatedSearches[]
stringoptional

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.