> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/duckduckgo>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/duckduckgo.mdx>

---

# DuckDuckGo API. Search results and answers as JSON.

Web, news, video and image results, where a site ranks, instant answers and suggestions, in any DuckDuckGo region. One consistent shape and one credit per request.

- 7 endpoints
- 63 regions
- 1 credit per request

Social Fetch exposes 7 routes under `/v1/duckduckgo`. `GET /v1/duckduckgo/search` returns a page of web results with titles, links, shown addresses and snippets, with sponsored results kept apart in `ads`, and pages with a cursor. `GET /v1/duckduckgo/rank` checks where a site ranks for a query, reading up to 200 results deep and stopping at the first match. `GET /v1/duckduckgo/news`, `GET /v1/duckduckgo/videos` and `GET /v1/duckduckgo/images` search DuckDuckGo News, Videos and Images, with image filters for size, colour, type, layout, licence and date. `GET /v1/duckduckgo/instant-answer` returns DuckDuckGo's summary, facts and direct answer for a topic, and `GET /v1/duckduckgo/search/suggest` completes a partial query.

A region is a country plus a language: `country=GB`, or `country=CH&language=fr`. Without a country the results are DuckDuckGo's US English region. `time` limits web, news and image results to the past day, week, month or year.

Every response uses the `{ data, meta }` envelope. Web, news, video and image search page with `cursor`: pass `page.nextCursor` to get the next page. A rank check that does not find the site answers `lookupStatus: not_found`, with how many results it checked.

## What you can get

- Web results with `position`, `title`, `url`, `displayUrl` and `snippet`, positions counting across pages, repeats dropped.
- Sponsored results apart in `ads`, with the advertiser's domain.
- Rank checks up to 200 results deep: the site's best `position`, the matching result and every position on the page it was found.
- News with source, publication time and image; videos with duration, publisher, uploader, views and thumbnail.
- Images with size, format, thumbnail and source page, filtered by size, colour, type, layout, licence and date.
- Instant answers with summary, source, facts, direct answers, definitions and related topics.
- Search suggestions for the start of a query, in any of 63 regions.

## DuckDuckGo endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Web search | GET /v1/duckduckgo/search | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/duckduckgo/search/get) |
| Rank check | GET /v1/duckduckgo/rank | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/duckduckgo/rank/get) |
| News search | GET /v1/duckduckgo/news | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/duckduckgo/news/get) |
| Video search | GET /v1/duckduckgo/videos | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/duckduckgo/videos/get) |
| Image search | GET /v1/duckduckgo/images | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/duckduckgo/images/get) |
| Instant answer | GET /v1/duckduckgo/instant-answer | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/duckduckgo/instant-answer/get) |
| Search suggestions | GET /v1/duckduckgo/search/suggest | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/duckduckgo/search/suggest/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_...`). New accounts get 100 free credits, enough to try every DuckDuckGo route.
2. **Pick the route and the region.** Use `GET /v1/duckduckgo/search?query=marathon%20training%20plan&country=GB` for web results, or `GET /v1/duckduckgo/rank?query=marathon%20training%20plan&domain=halhigdon.com` for a rank check. Send `x-api-key` on every request.
3. **Page and bill.** Follow `page.nextCursor` while `page.hasMore` is true, and read `meta.creditsCharged` for the charge.

## Pricing

Every DuckDuckGo route charges one credit per completed request, shown on each endpoint page. A rank check is one request however deep it reads. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

DuckDuckGo offers no API for its web, news, video or image results. Social Fetch reads what DuckDuckGo shows every visitor and returns it as one JSON shape, with regions, time windows and paging handled the same way on every route.

## FAQ

### Is there a DuckDuckGo search API?

Yes. GET /v1/duckduckgo/search returns DuckDuckGo's web results for a query as JSON: position, title, URL, shown address and snippet for each result, sponsored results apart, and a cursor for the next page. Authenticate with your Social Fetch API key in x-api-key.

### How does the rank check work?

GET /v1/duckduckgo/rank reads DuckDuckGo's results for the query page by page until the site appears, the depth is reached (up to 200 results) or the results end. It returns the site's best position and result, and lookupStatus not_found with checkedResults when the site is not there. It costs one credit however many pages it reads.

### Which regions can I search?

Any of DuckDuckGo's 63 regions, picked with country and, where a country has several, language: country=GB is the UK, country=CH&language=fr is Switzerland in French. A country DuckDuckGo has no region for answers 400 and is not charged.

### Are ads mixed into the results?

No. Sponsored results are returned in ads with their title, the advertiser's domain, the address shown and the ad text. results holds only the organic results, and positions count only those.

### Can I page through news, videos and images?

Yes. Each page holds about 30 articles, 60 videos or 100 images; pass page.nextCursor as cursor for the next one. Use time to narrow news to the past day, week, month or year, and videos to the past day, week or month.

### What does an instant answer include?

For a topic DuckDuckGo knows: its heading, a summary with its source and URL, facts such as dates and places, the official website, a direct answer for questions like 2+2, a definition for words, and related topics. A topic with nothing answers lookupStatus not_found.

### How much does the DuckDuckGo API cost?

Every DuckDuckGo route charges one credit per completed request, and each page of web results is billed separately. Read meta.creditsCharged on every response. New accounts start with 100 free credits.

### Can I use the DuckDuckGo routes from agents or MCP?

Yes. Every DuckDuckGo route is a typed MCP tool and is reachable through Ask (POST /v1/ask) in plain English. Use the typed routes for production jobs.

## Related

- [DuckDuckGo Search API](https://www.socialfetch.dev/platforms/duckduckgo/search): Web results with paging and ads apart (`GET /v1/duckduckgo/search`).
- [DuckDuckGo Rank Checker API](https://www.socialfetch.dev/platforms/duckduckgo/rank): Where a site ranks, up to 200 deep (`GET /v1/duckduckgo/rank`).
- [DuckDuckGo News API](https://www.socialfetch.dev/platforms/duckduckgo/news): News articles for a query (`GET /v1/duckduckgo/news`).
- [DuckDuckGo Instant Answer API](https://www.socialfetch.dev/platforms/duckduckgo/instant-answer): Summary, facts and answers for a topic (`GET /v1/duckduckgo/instant-answer`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language DuckDuckGo question to the matching operation.
