DuckDuckGo Light API

Our DuckDuckGo Light API allows you to scrape results from the DuckDuckGo page with lightning-fast speeds. The DuckDuckGo Light engine contains all the most critical data, but without the extra-rich results you usually find on a regular DuckDuckGo page. This allows for faster response times compared to our regular DuckDuckGo Search API.

The API is accessed through the following endpoint: /search?engine=duckduckgo_light.

You can query: https://serpapi.com/search?engine=duckduckgo_light&q=coffee utilizing a GET request. Head to the playground for a live and interactive demo.

Chart

API Parameters

Search Query

q

Required

Parameter defines the query you want to search. You can use anything that you would use in a regular DuckDuckGo search. (e.g., inurl:, site:, intitle:, etc.)

Localization

kl

Optional

Parameter defines the region to use for the DuckDuckGo search. Region code examples: us-en for the United States, uk-en for United Kingdom, or fr-fr for France. Head to the DuckDuckGo regions for a full list of supported regions.

Advanced Duckduckgo Filters

df

Optional

Parameter defines results filtered by date.

It can be set to:
d: Past day,
w: Past week,
m: Past month,
y: Past year,

or you can pass a custom date following the next format: from_date + .. + to_date (e.g. 2021-06-15..2024-06-16).

Pagination

next_page_token

Optional

Parameter defines the next page token. It is used for retrieving the next page results. 15 results are returned per page.

Serpapi Parameters

engine

Required

Set parameter to duckduckgo_light to use the DuckDuckGo Light API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the DuckDuckGo Light results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

API Results

JSON Results

JSON output includes structured data for Organic Results, Ads Results, Knowledge Graph.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

HTML output is useful to debug JSON results or support features not supported yet by SerpApi. HTML output gives you the raw HTML results from DuckDuckGo Light.

API Examples

Results for: Coffee

Results for: Coffee

JSON Example

{
  "search_metadata": {
    "id": "68399481ac29780996699bdf",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/84b1f8bfab22956c/68399481ac29780996699bdf.json",
    "created_at": "2025-05-30 11:20:33 UTC",
    "processed_at": "2025-05-30 11:20:33 UTC",
    "duckduckgo_light_url": "https://html.duckduckgo.com/html/",
    "raw_html_file": "https://serpapi.com/searches/84b1f8bfab22956c/68399481ac29780996699bdf.html",
    "total_time_taken": 1.32
  },
  "search_parameters": {
    "engine": "duckduckgo_light",
    "q": "Coffee",
    "kl": "us-en"
  },
  "search_information": {
    "organic_results_state": "Results for exact spelling"
  },
  "ads": [
    {
      "position": 1,
      "title": "Clean Coffee Made Easy - Popular Coffee Mix-ins Ad Viewing ads is privacy protected by DuckDuckGo. Ad clicks are managed by Microsoft's ad network (more info).",
      "link": "https://duckduckgo.com/y.js?ad_domain=bulletproof.com&ad_provider=bingv7aa&ad_type=txad&click_metadata=svrWSeSeWzk36Qjv1O6yk9SPUa5VH%2DVoPbTwZyO2gPodoYqjowG4b4JnI2mM5x2oXz4eAYmnYhD7Lq0luVlvIi6VeBPHZo%2DYWVZU9bpjJUHuwOW8Bt0od0r9el3F4y4B.43XeLfes5YB0m3nT8KN0MA&rut=e5844588bdc236c305c6d47700eac163e6a8b4db7e5c111224fb12bb73125132&u3=https%3A%2F%2Fwww.bing.com%2Faclick%3Fld%3De8NxTumrQgmaJF%2DXroGt%2DFhDVUCUwZx_%2DKJecun_%2DJx9hxfb2Bh8WC%2DdrfwP4tvj5auArrfgsBZZbz7WzOyhG6uLQMHvW_CErw8NpSc4s_1mW0v4UrqUtDnshIvw9oWSWaHkfbBq7jDXuJe_bvsX6HfgjNwel7xdDvX5u8gdqkAzZt6FjWOioA_TTsjhUnwWnrCEiHaQ%26u%3DaHR0cHMlM2ElMmYlMmZzaG9wLmJ1bGxldHByb29mLmNvbSUyZmNvbGxlY3Rpb25zJTJmc3RhcnRlci1raXRzJTNmbXNjbGtpZCUzZGNlNDFkYzY3ZWJmNjE4NGE2N2U3YjQ1ZTdmNzQ0NmIzJTI2dXRtX3NvdXJjZSUzZGJpbmclMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX2NhbXBhaWduJTNkUE1heCUyNTIwJTI1N0MlMjUyMENvcmUlMjUyMCUyNTdDJTI1MjBNaXgtSW5zJTI1MjAlMjU3QyUyNTIwVVMlMjUyMCUyNTdDJTI1MjBST0FTJTI2dXRtX3Rlcm0lM2RzaG9wLmJ1bGxldHByb29mLmNvbSUyNnV0bV9jb250ZW50JTNkQ29yZSUyNTIwJTI1N0MlMjUyMEtpdHMlMjUyMCUyNTI2JTI1MjBHaGVl%26rlid%3Dce41dc67ebf6184a67e7b45e7f7446b3&vqd=4-207571538713811304394050936699421108537&iurl=%7B1%7DIG%3D60175C25A9AD4801BFD51E38F7FD5A39%26CID%3D30E80267745366B7315E179B75946741%26ID%3DDevEx%2C5047.1",
      "displayed_link": "bulletproof.com",
      "direct_link": "https://shop.bulletproof.com/collections/starter-kits?msclkid=ce41dc67ebf6184a67e7b45e7f7446b3&utm_source=bing&utm_medium=cpc&utm_campaign=PMax%20%7C%20Core%20%7C%20Mix-Ins%20%7C%20US%20%7C%20ROAS&utm_term=shop.bulletproof.com&utm_content=Core%20%7C%20Kits%20%26%20Ghee",
      "snippet": "Bulletproof products help provide the fuel for your healthy lifestyle. Subscribe and Save 30% plus receive free shipping. Free shipping on all orders over $49"
    },
    {
      "position": 2,
      "title": "Healthiest Coffee Made For You - Discover Lifeboost Coffee Ad Viewing ads is privacy protected by DuckDuckGo. Ad clicks are managed by Microsoft's ad network (more info).",
      "link": "https://duckduckgo.com/y.js?ad_domain=lifeboostcoffee.com&ad_provider=bingv7aa&ad_type=txad&click_metadata=ZcNmecC0ifZ4xn%2Dd2laHcly5KjCmLgDdTUO5ln_xUj7R5XcZ1_b%2DwGbwhVs3gzD9TD64%2DoiHy9h%2DidwX9L5uEKjvpU6Uv6N0xQcrcdkmVE%2DGKFtQhD7A3PhSV58VzM%2Dj.wzMiSB70q2A5fFbnY3O6IQ&rut=7d1a176db5353038de382ac3e7cab4b8450a2de1049f85168f3d66fbfdfcf32d&u3=https%3A%2F%2Fwww.bing.com%2Faclick%3Fld%3De8V5N5LnRmo_86eGan8yPsIDVUCUxq2e_v5viG%2DalRyU3iddkfbAm26tJDYurPTF3uiPmYnapNyw_VjCuTXHbQc%2DlGj3KKYqRhR_M4r%2DkGA%2DGHaZR6W%2Du5NDCq7R4HU3ejxEik5iXHZZCcxmbJLoi7Y_w1dO7W0xwQDrCj5cQTzzG5E9QXmIV2hW8ldbRTRw3Hm6EFMA%26u%3DaHR0cHMlM2ElMmYlMmZsaWZlYm9vc3Rjb2ZmZWUuY29tJTJmY29sbGVjdGlvbnMlMmZzcHJpbmctZmxhdm9ycyUzZm5iX3NpJTNkJTdic291cmNlaWQlN2QlMjZ1dG1fc291cmNlJTNkYmluZyUyNnV0bV9tZWRpdW0lM2RjcGMlMjZ1dG1fY2FtcGFpZ24lM2Q1MzA4Mzk4NzYlMjZ1dG1fY29udGVudCUzZDEzNjIyOTc0MTI3NDE1NDklMjZuYnQlM2RuYiUyNTNBbWljcm9zb2Z0JTI1M0FzJTI1M0E1MzA4Mzk4NzYlMjUzQTEzNjIyOTc0MTI3NDE1NDklMjUzQTg1MTQzOTkzNTY0NjMwJTI2bmJfbXQlM2RiJTI2bmJfYm10JTNkYmIlMjZuYl9vaWklM2Q4NTE0NDcyMDgxNjUxNiUyNm5iX3FzJTNkQ29mZmVlJTI2bmJfZmlpJTNkJTI2bmJfbGlfbXMlM2QlMjZuYl9scF9tcyUzZDk3NjMyJTI2bmJfcGklM2QlMjZuYl9wYyUzZCUyNm5iX2NpJTNkJTI2bXNjbGtpZCUzZGYyZWJiYTBjNmRhODFlMGQ3YzU0ZDIzNWY5MmE1MTNiJTI2dXRtX3Rlcm0lM2RzdG9tYWNoLWZyaWVuZGx5JTI1MjBjb2ZmZWU%26rlid%3Df2ebba0c6da81e0d7c54d235f92a513b&vqd=4-30717342991489078040237121589486299579&iurl=%7B1%7DIG%3D60175C25A9AD4801BFD51E38F7FD5A39%26CID%3D30E80267745366B7315E179B75946741%26ID%3DDevEx%2C5052.1",
      "displayed_link": "lifeboostcoffee.com",
      "direct_link": "https://lifeboostcoffee.com/collections/spring-flavors?nb_si={sourceid}&utm_source=bing&utm_medium=cpc&utm_campaign=530839876&utm_content=1362297412741549&nbt=nb%3Amicrosoft%3As%3A530839876%3A1362297412741549%3A85143993564630&nb_mt=b&nb_bmt=bb&nb_oii=85144720816516&nb_qs=Coffee&nb_fii=&nb_li_ms=&nb_lp_ms=97632&nb_pi=&nb_pc=&nb_ci=&msclkid=f2ebba0c6da81e0d7c54d235f92a513b&utm_term=stomach-friendly%20coffee",
      "snippet": "Enjoy a Cup of Healthy, Invigorating, Stomach-Friendly Coffee. Certified & Single Sourced. Pack Your Pantry with Light to Dark Roast, Decaf, Flavored, Probiotic, and More!"
    }
  ],
  "organic_results": [
    {
      "position": 1,
      "title": "The Best Coffee Shops in New York City - Eater NY",
      "link": "https://ny.eater.com/maps/best-cafe-coffee-shop-new-york-city-brooklyn-queens",
      "displayed_link": "ny.eater.com/maps/best-cafe-coffee-shop-new-york-city-brooklyn-queens",
      "date_raw": "2025-03-10T16:07:00.0000000",
      "date": "Mar 10, 2025",
      "snippet": "Find expertly brewed cups of coffee and award-winning pastries at these cafes in New York City, from the Bronx to Brooklyn. Explore the diversity of neighborhoods, cuisines, and prices with Eater's curated map and reviews.",
      "favicon": "https://external-content.duckduckgo.com/ip3/ny.eater.com.ico"
    },
    {
      "position": 2,
      "title": "21 Best Coffee Shops in NYC For Lattes, Iced Coffees and Espresso",
      "link": "https://www.timeout.com/newyork/restaurants/best-coffee-shops-in-new-york",
      "displayed_link": "www.timeout.com/newyork/restaurants/best-coffee-shops-in-new-york",
      "date_raw": "2024-07-08T00:00:00.0000000",
      "date": "Jul 8, 2024",
      "snippet": "Find your new favorite spot for a morning iced coffee or an afternoon matcha at these coffee shops, cafés and bakeries. They serve up the best lattes, cold brews and matcha in the city, as well as inventive drinks, sandwiches and pastries.",
      "favicon": "https://external-content.duckduckgo.com/ip3/www.timeout.com.ico"
    },
    {
      "position": 3,
      "title": "15 TOP-NOTCH Coffee Shops in New York City (Worth a Detour)",
      "link": "https://newyorkspork.com/best-coffee-nyc/",
      "displayed_link": "newyorkspork.com/best-coffee-nyc/",
      "date_raw": "2025-02-05T00:00:00.0000000",
      "date": "Feb 5, 2025",
      "snippet": "Incapable of playing second fiddle, New York City offers the best of everything and coffee is no exception. Chock-full of charming corner cafes and shoe-box sized coffee shops, you'll find everything from the latest artisanal brews to time-honored institutions that have been serving New Yorkers for 100+ years. On that note, here's a quick roundup of the best coffee in New York City.",
      "favicon": "https://external-content.duckduckgo.com/ip3/newyorkspork.com.ico"
    },
    ...
  ],
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?engine=duckduckgo_light&kl=us-en&next_page_token=eyJxIjoiQ29mZmVlIiwicyI6IjEwIiwibmV4dFBhcmFtcyI6IiIsInYiOiJsIiwibyI6Impzb24iLCJkYyI6IjEzIiwiYXBpIjoiZC5qcyIsInZxZCI6IjQtMzE5NDEwNzE2NjI3NDM1NDk2NTkyMjEzNjA3Mzg3MTQ0NDk4MzUxIiwia2wiOiJ1cy1lbiJ9&q=Coffee",
    "next_page_token": "eyJxIjoiQ29mZmVlIiwicyI6IjEwIiwibmV4dFBhcmFtcyI6IiIsInYiOiJsIiwibyI6Impzb24iLCJkYyI6IjEzIiwiYXBpIjoiZC5qcyIsInZxZCI6IjQtMzE5NDEwNzE2NjI3NDM1NDk2NTkyMjEzNjA3Mzg3MTQ0NDk4MzUxIiwia2wiOiJ1cy1lbiJ9"
  }
}