# DuckDuckGo Images API (https://www.socialcrawl.dev/platforms/duckduckgo/images)

> Returns DuckDuckGo Images results with the image, thumbnail, size, source page and domain, filterable by size, colour, type, layout and licence.

TL;DR: `GET /v1/duckduckgo/images` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | The search, for example nike logo. |
| `region` | no | Region code such as us-en, uk-en or de-de (64 codes), or wt-wt for no region. Default us-en. |
| `safe_search` | no | strict, moderate or off. (strict \| moderate \| off) |
| `time_range` | no | any, day, week, month or year. (any \| day \| week \| month \| year) |
| `size` | no | small, medium, large or wallpaper. (small \| medium \| large \| wallpaper) |
| `color` | no | color, monochrome, or one of red, orange, yellow, green, blue, purple, pink, brown, black, gray, teal or white. |
| `type` | no | photo, clipart, gif, transparent or line. (photo \| clipart \| gif \| transparent \| line) |
| `layout` | no | square, tall or wide. (square \| tall \| wide) |
| `license` | no | any, public, share, share_commercially, modify or modify_commercially. (any \| public \| share \| share_commercially \| modify \| modify_commercially) |
| `limit` | no | Images to return, 1 to 30. Default 30. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/duckduckgo/images" \
  --data-urlencode "query=nike logo" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search DuckDuckGo Images with an API?

Call GET /v1/duckduckgo/images with query set to the search, for example nike logo. limit sets how many images come back.

### What does each image result include?

Each result has the image, thumbnail, size, source page and domain.

### Which image filters are available?

size takes small, medium, large or wallpaper. type takes photo, clipart, gif, transparent or line, and layout takes square, tall or wide. color takes color, monochrome or one of red, orange, yellow, green, blue, purple, pink, brown, black, gray, teal or white.

### Can I filter by licence?

Yes. license takes any, public, share, share_commercially, modify or modify_commercially.

### How much does this DuckDuckGo endpoint cost?

Each call costs 1 credit on the standard tier. There is no subscription, and 100 free credits cover 100 calls.

See the full DuckDuckGo API: https://www.socialcrawl.dev/platforms/duckduckgo

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I search images with licence filters using the DuckDuckGo API?
- Is there a DuckDuckGo image search API?