# DuckDuckGo images: `POST /v1/duckduckgo/images`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/duckduckgo-images

One page (about 100) of DuckDuckGo image results.

Each image has its title, full-size `image` URL with width and height, a
thumbnail, and the page it appears on (`link`). DuckDuckGo's own filters
apply: `size`, `color`, `type`, `layout`, `license` and `time`, with
`region` and `safe_search`. An empty page is not billed.

Request body (JSON):

- `q` (string; required; min length 1, max length 500): Search query.
- `region` (string | null; optional; pattern ^[a-z]{2}-[a-z]{2,3}$): DuckDuckGo region: 'us-en', 'uk-en', 'de-de', 'fr-fr', 'jp-jp' … ('wt-wt' or empty for no region).
- `safe_search` (string | null; optional; one of strict, moderate, off): Safe search: 'strict' or 'off' ('moderate' is strict for images).
- `size` (string | null; optional; one of Small, Medium, Large, Wallpaper): Image size.
- `color` (string | null; optional; one of color, Monochrome, Red, Orange, Yellow, Green, Blue, Purple, Pink, Brown, Black, Gray, Teal, White): 'color' (any colour), 'Monochrome' or a colour.
- `type` (string | null; optional; one of photo, clipart, gif, transparent, line): Image type: photo, clip art, animated GIF, transparent background or line drawing.
- `layout` (string | null; optional; one of Square, Tall, Wide): Image shape.
- `license` (string | null; optional; one of any, Public, Share, ShareCommercially, Modify, ModifyCommercially): Usage rights the image is published under.
- `time` (string | null; optional; one of d, w, m, y): Only images from the past day, week, month or year.
- `page` (integer; optional; default 1; min 1, max 20): Result page.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
