DuckDuckGo API Documentation
DuckDuckGo API uses /api/v1/search?engine=duckduckgo
API endpoint to scrape real-time results.
API Parameters
Search Query
-
- Name
-
q
- Required
- Required
- Description
-
Defines the search term for DuckDuckGo. You can also use advanced operators supported by DuckDuckGo, such as
site:
,intitle:
, orinurl:
to refine your search.
Localization
-
- Name
-
locale
- Required
- Optional
- Description
-
Specifies the country and language for your search. The default parameter is
us-en
. Check the full list of supported DuckDuckGo locales.
Filters
-
- Name
-
safe
- Required
- Optional
- Description
-
Specifies the filter level for adult content. Available values are:
-
on
Default moderate
off
-
-
- Name
-
time_period
- Required
- Optional
- Description
-
Filters results by date. Predefined values are:
-
any_time
Default past_year
past_month
past_week
past_day
YYYY-MM-DD..YYYY-MM-DD
-
Pagination
-
- Name
-
page
- Required
- Optional
- Description
-
Defines the page index for retrieving search results. The first page contains approximately 20–30
organic_results
, while each subsequent page retrieves 50 results.
Engine
-
- Name
-
engine
- Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
duckduckgo
.
Api Key
-
- Name
-
api_key
- Required
- Required
- Description
-
The
api_key
authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY
) or in the Authorization header (Bearer YOUR_API_KEY
).
API Examples
Organic Results
https://www.searchapi.io/api/v1/search?engine=duckduckgo&q=x
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "duckduckgo",
"q": "x"
}
response = requests.get(url, params = params)
print(response.text)
{
"organic_results": [
{
"position": 1,
"title": "X - Official Site",
"link": "https://www.x.com/",
"snippet": "From breaking news and entertainment to sports and politics, get the full story with all the live commentary.",
"snippet_highlighted_words": [
"news",
"entertainment",
"sports",
"politics"
],
"sitelinks": [
{
"title": "Download the X app",
"link": "https://help.x.com/en/using-x/download-the-x-app",
"snippet": "Download X for iOS. Download X for Android. Download the X app on your device. The X app is the trusted global digital town square for everyone. With X, you can: Post content for the world to see and join public conversations. Stay up to date on breaking news and follow your interests. Stay better informed with extra context from Community Notes."
},
...
],
"favicon": "https://external-content.duckduckgo.com/ip3/www.x.com.ico"
},
...
]
}
Ads
https://www.searchapi.io/api/v1/search?engine=duckduckgo&q=dropshipping
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "duckduckgo",
"q": "dropshipping"
}
response = requests.get(url, params = params)
print(response.text)
{
"ads": [
{
"position": 1,
"title": "Shopify Dropshipping Success - Shopify Dropshipping for $1",
"tracking_link": "https://duckduckgo.com/y.js?ad_domain=autods.com&ad_provider...",
"link": "https://platform.autods.com/register/?cta...",
"source": "autods.com",
"snippet": "Find winning dropshipping products instantly without hours of manual research. Save time with automated dropshipping on Shopify, eBay, Amazon and more. Try it for $1",
"snippet_highlighted_words": [
"dropshipping"
],
"structured_snippet": "Service catalog: Shopify, eBay, Facebook, Etsy, WooCommerce, Amazon",
"promotion": {
"description": "Try It For $1",
"code": "BF2024",
"expiration": "October 31, 2024",
"occasion": "Black Friday",
"link": "https://platform.autods.com/...",
"tracking_link": "https://duckduckgo.com/y.js?ad_domain=autods.com&ad_provider..."
},
"sitelinks": [
{
"title": "Login Now",
"link": "https://duckduckgo.com/y.js?ad_domain=autods.com&ad_provider...",
"tracking_link": "https://platform.autods.com/...",
"snippet": "Login To Autods.com Manage Your Account Today!"
},
...
],
"favicon": "https://external-content.duckduckgo.com/ip3/autods.com.ico"
},
...
]
}
Knowledge Graph
https://www.searchapi.io/api/v1/search?engine=duckduckgo&q=steve+jobs
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "duckduckgo",
"q": "steve jobs"
}
response = requests.get(url, params = params)
print(response.text)
{
"knowledge_graph": {
"title": "Steve Jobs",
"subtitle": "American entrepreneur; co-founder of Apple Inc. (1955–2011)",
"website": "https://apple.com/stevejobs",
"description": "Steven Paul Jobs was an American businessman, inventor, and investor best known for co-founding the technology company Apple Inc. Jobs was also the founder of NeXT and chairman and majority shareholder of Pixar. He was a pioneer of the personal computer revolution of the 1970s and 1980s, along with his early business partner and fellow Apple co-founder Steve Wozniak. Jobs was born in San Francisco in 1955 and adopted shortly afterwards. He attended Reed College in 1972 before withdrawing that same year. In 1974...",
"text": {
"name": "Wikipedia",
"link": "https://en.wikipedia.org/wiki/Steve_Jobs"
},
"facts": {
"born": "Steven Paul Jobs, February 24, 1955, San Francisco, California, U.S.",
"age_at_death": "56 years",
"died": "October 05, 2011, Palo Alto, California, U.S.",
"resting_place": "Alta Mesa Memorial Park",
"education": "Reed College (attended)",
"years_active": "1971–2011",
"board_member_of": "The Walt Disney Company, Apple Inc.",
"partner(s)": "Chrisann Brennan (1972–1977)",
"children": "4, including Lisa, Reed, and Eve",
"relatives": "Mona Simpson (sister), Bassma Al Jandaly (cousin), Malek Jandali (cousin)",
"awards": "Presidential Medal of Freedom (posthumous, 2022)"
},
"profiles": [
{
"name": "IMDb ID",
"link": "https://www.imdb.com/name/nm0423418",
"thumbnail": "https://duckduckgo.com/assets/icons/thirdparty/imdb.svg"
},
...
],
"people_also_search_for": [
{
"query": "Steve Jobs Category",
"link": "https://duckduckgo.com/c/Steve_Jobs"
},
...
],
"thumbnail": "https://duckduckgo.com/i/117a0871ebc7a86a.jpg"
}
}
AI Overview
https://www.searchapi.io/api/v1/search?engine=duckduckgo&q=Who+is+the+tallest+person+in+the+world%3F
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "duckduckgo",
"q": "Who is the tallest person in the world?"
}
response = requests.get(url, params = params)
print(response.text)
{
"ai_overview": {
"answer": "The tallest person in the world was Robert Wadlow, who stood at 8 feet 11.1 inches tall. He was born on February 22, 1918, and holds the title for the tallest man ever recorded.",
"sources": [
{
"link": "https://en.wikipedia.org/wiki/List_of_tallest_people",
"source": "Wikipedia",
"title": "List of tallest people"
}
...
]
}
}
Top Stories
https://www.searchapi.io/api/v1/search?engine=duckduckgo&q=stock+market+news
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "duckduckgo",
"q": "stock market news"
}
response = requests.get(url, params = params)
print(response.text)
{
"top_stories": [
{
"title": "Stock Market Today: Dow futures lean higher after first full week of earnings",
"link": "https://www.marketwatch.com/livecoverage/stock-market-today-dow-futures-lean-higher-after-first-full-week-of-earnings",
"source": "MarketWatch",
"date": "2024-10-25T09:46:00Z",
"snippet": "Investing legend Jim Rogers expects an 'extremely bad' recession. Why he's buying silver instead of gold.",
"thumbnail": "https://images.mktw.net/im-00671980/social"
},
...
]
}
Inline Images
https://www.searchapi.io/api/v1/search?engine=duckduckgo&q=beaver
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "duckduckgo",
"q": "beaver"
}
response = requests.get(url, params = params)
print(response.text)
{
"inline_images": [
{
"title": "Beaver",
"source": {
"name": "Bing",
"link": "https://kids.nationalgeographic.com/animals/mammals/facts/beaver"
},
"original": {
"link": "https://i.natgeofe.com/k/3892766d-ad0e-4027-9cca-a03708fcd1e6/beaver-closeup_16x9.jpg?w=1200",
"height": 675,
"width": 1200
},
"thumbnail": "https://tse1.mm.bing.net/th?id=OIP.TvjopbcOnAtQInuxLJGQLwHaEK&pid=Api"
},
...
]
}
Inline Videos
https://www.searchapi.io/api/v1/search?engine=duckduckgo&q=bear+videos
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "duckduckgo",
"q": "bear videos"
}
response = requests.get(url, params = params)
print(response.text)
{
"inline_videos": [
{
"position": 1,
"title": "Playful Bear Cub Grows Big Enough to Climb a Tree | Animal Videos For ...",
"link": "https://www.youtube.com/watch?v=9vhpV8tc_LA",
"video_link": "http://www.youtube.com/embed/9vhpV8tc_LA?autoplay=1",
"source": "YouTube",
"channel": "Dodo Kids",
"views": 3373430,
"date": "2020-07-26T12:00:02.0000000",
"thumbnail": "https://tse1.mm.bing.net/th?id=OVP.yTkY9aIpi2iaW9uFWBpAZwEsDh&pid=Api"
},
...
]
}
Related Searches
https://www.searchapi.io/api/v1/search?engine=duckduckgo&q=apple
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "duckduckgo",
"q": "apple"
}
response = requests.get(url, params = params)
print(response.text)
{
"related_searches": [
{
"query": "apple store online shopping",
"link": "https://duckduckgo.com/?q=apple%20store%20online%20shopping"
},
...
]
}