Skip to main content

Scraper API for DuckDuckGo

The ScrapeBadger DuckDuckGo API turns DuckDuckGo into a clean JSON feed: the web SERP with ads flagged and the zero-click abstract box, image search with size/color/type/layout/license filters, news with both relative and absolute dates, video search with view counts and embed URLs, search-box autocomplete, the Instant Answer API, and the full region code list.
All endpoints are GET, live under https://scrapebadger.com/v1/duckduckgo/*, and authenticate with the X-API-Key header. Credits are charged per request (see the table below) and reported on the X-Credits-Used response header.

Features

  • Web search — organic results with title, url, snippet, display_url; ad results are returned and flagged is_ad so you can include or exclude them yourself. The zero-click abstract box (heading, text, source, image) is attached when DuckDuckGo shows one.
  • Image search — 100 results per page with dimensions, source page, encoding format and discovery date, filterable by size, color, image_type, layout and license.
  • News search — 30 results per page; every date ships in both forms: date_utc (Unix seconds) and date_at (ISO 8601 UTC), plus DuckDuckGo’s own relative_time and the syndicate it aggregated from.
  • Video search — 60 results per page with publisher, uploader, duration, view_count, thumbnails and embed_url.
  • Autocomplete — search-box suggestions for a partial query, region-aware.
  • Instant Answers — DuckDuckGo’s entity/abstract/definition/direct-answer API for reference queries, with related_topics.
  • Region targeting — every search endpoint takes a region (DuckDuckGo kl code, e.g. us-en); wt-wt (All Regions, no locale bias) is the default. /regions lists all supported codes, free.

Regions

region is a DuckDuckGo kl code — country-language, e.g. us-en, uk-en, de-de, fr-fr, jp-jp. The default wt-wt means All Regions (no locale bias). List every supported code with /regions (free).

Credits

Quickstart

Pagination

Every search endpoint pages with a page parameter and returns has_next — page on that, not on result_count.

Other notes

  • SafeSearch — safesearch accepts on, moderate (default) or off on /search, /images, /news and /videos.
  • Time filters — timelimit (day, week, month, year) narrows /search and /news to recent results; omit it for all time.
  • Instant Answers are entity-shaped. /instant answers reference queries (people, places, definitions, calculations); most long-tail search phrases return an empty payload — that is DuckDuckGo’s behaviour, not an error. Use /search for general queries.
  • Datetimes ship in both forms — news dates come as date_utc (Unix seconds) and date_at (ISO 8601 UTC string).

Errors

Start from /autocomplete (2 credits) to expand a partial term into real DuckDuckGo queries, then run /search on each one and merge on url.

Run this asynchronously

Calls on this API can run in the background, so you don’t hold a connection open while they work. Add one of these to the call:
An async call is billed once, when it completes. See Async requests and webhooks for webhooks, signatures and the SDK helpers.
ScrapeBadger is an independent tool and is not affiliated with, endorsed by, or sponsored by DuckDuckGo. “DuckDuckGo” is a trademark of DuckDuckGo, Inc., used here only to describe the platform this scraper is designed to work with.