Skip to main content

​
Overview

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 (1 credit) to expand a partial term into real DuckDuckGo queries, then run /search on each one and merge on url.