using System;
using System.Net.Http;
class Program
{
static async Task Main()
{
var client = new HttpClient();
var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
query["engine"] = "duckduckgo_news";
query["q"] = "Coffee";
query["no_cache"] = "false";
query["api_key"] = "YOUR_API_KEY";
var response = await client.GetAsync(
$"https://serpapi.abcproxy.com/search?{query}"
);
Console.WriteLine(await response.Content.ReadAsStringAsync());
}
}
import java.net.*;
import java.io.*;
public class Main {
public static void main(String[] args) throws Exception {
String url = "https://serpapi.abcproxy.com/search" +
"?engine=duckduckgo_news" +
"&q=Coffee" +
"&no_cache=false" +
"&api_key=YOUR_API_KEY";
HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
conn.setRequestMethod("GET");
BufferedReader in = new BufferedReader(
new InputStreamReader(conn.getInputStream())
);
String response = in.lines().collect(Collectors.joining());
System.out.println(response);
}
}
API Parameters
Search Query
Name
Type
Required
Description
Example
q
string
Yes
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.)
123
Localization
Name
Type
Required
Description
Example
kl
string
No
en
Advanced Duckduckgo Filters
Name
Type
Required
Description
Example
safe
string
No
Parameter defines the level of filtering for adult content. It can be set to 1 (Strict), -1 (Moderate - default), or -2 (Off).
-1
df
string
No
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..2021-06-16).
-
Pagination
Name
Type
Required
Description
Example
start
string
No
Parameter defines the result offset. It skips the given number of results. It's used for pagination. When pagination is not being used (initial search request), number of organic_results can vary between 26 and 30. When pagination is being used (value of start parameter is bigger than 0), organic_results return 50 results.
-
Serpapi Parameters
Name
Type
Required
Description
Example
engine
string
Yes
Set parameter to duckduckgo_news to use the DuckDuckGo News API engine.
duckduckgo_news
no_cache
boolean
No
Parameter will force SerpApi to fetch the Google Play 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.
trueorfalse
api_key
string
Yes
Parameter defines the SerpApi private key to use.
-
Response
Success 200
Response Body
{
"search_metadata": {
"id": "49529af2-2da2-401c-99a7-37cc8a323687",
"json_endpoint": "https://webserp.abcproxy.com/files/fd28d1514734870c/49529af2-2da2-401c-99a7-37cc8a323687.json",
"created_at": "2025-04-02 16:47:01",
"google_news_url": "https://duckduckgo.com?ia=web&q=Coffee",
"raw_html_file": "https://webserp.abcproxy.com/files/fd28d1514734870c/49529af2-2da2-401c-99a7-37cc8a323687.html",
"xray_html_file": "https://webserp.abcproxy.com/files/fd28d1514734870c/49529af2-2da2-401c-99a7-37cc8a323687.xray",
"total_time_taken": "35.6634"
},
"search_parameters": {
"engine": "duckduckgo",
"no_cache": true,
"api_key": "YOUR_API_KEY",
"q": "Coffee"
}
"ads": [
{
"position": 1,
"title": "Keurig® Official Site - Fast & Free Shipping",
"snippet": "Winter sale alert! Shop 400+ coffee options from your favorite brands only at keurig.com. Buy coffee from keurig.com and skip the long grocery store lines.56% off Refreshers Bundle • Valid Feb 27 - Apr 16",
"sitelinks": [
{
"link": "https://duckduckgo.com/y.js?ad_domain=keurig.com&ad_provider=bingv7aa&ad_type=txad&click_metadata=ZY2MgVPXN2rj6n_jnuBHdW1g0ySik5llSJEy7Bf5BdItm2lGK8Jx4%2DaIH3SpO5S26fE2spQ0DcLDE2REV7JIWq5JZOhY%2DaJ55ilm_go%2DvGfR0wosBio_4FbYRS1t_F5G.uaZkOVqW2QnKGvj8LW0yYA&rut=493c5952ceec34325b3481d069eadff2fc38a4e705a9c4295d24056145ad113f&u3=https%3A%2F%2Fwww.bing.com%2Faclick%3Fld%3De8vp_BM0TFWRNxxNiUEnZg7TVUCUyzEyEBUbTYA_o4X4xT%2Da9I5KYHFicwGLH8aG6GyhE1qMkWsTYsHwVSH9XfGhwsrcA7BwwzPGlXFmdIeNTCCNagYDl4koqhYRedgukdPCV1zZgJ2Sx2N1xg%2DaDa%2Di29GVSkDxn6118BHzfbaolRKgIkLVRtYAmfnbUX4Kug1DQCMoIt2U_xymjJw5aJobJ61_U%26u%3DaHR0cHMlM2ElMmYlMmZhZC5kb3VibGVjbGljay5uZXQlMmZzZWFyY2hhZHMlMmZsaW5rJTJmY2xpY2slM2ZsaWQlM2Q0MzcwMDA4MTY1ODIyMDQxMyUyNmRzX3Nfa3dnaWQlM2Q1ODcwMDAwODg2NDcyOTA5MCUyNmRzX2FfY2lkJTNkOTc5MjcyMjI3JTI2ZHNfYV9jYWlkJTNkMjIzMzE4NDgwMTQlMjZkc19hX2FnaWQlM2QxNzk2OTcwODYxMDclMjZkc19hX2xpZCUzZGt3ZC0yNzE2NTczMjYyJTI2ZHNfeF9hZHhpZCUzZDgzNzAwMDI2MDM3Njk0NDcyJTI2ZHNfeF9hZHh0eXBlJTNkMSUyNmRzX2FfY2lkJTNkOTc5MjcyMjI3JTI2ZHNfYV9leHRpZCUzZDIxOTg1NzMyNzU2MCUyNmRzX2VfYWRpZCUzZDc5NzE0ODAyNjcxNDY4JTI2ZHNfZV90YXJnZXRfaWQlM2Rrd2QtNzk3MTUyMDU1NDgwNzQlM2Fsb2MtMTkwJTI2JTI2ZHNfZV9uZXR3b3JrJTNkbyUyNmRzX3VybF92JTNkMiUyNmRzX2Rlc3RfdXJsJTNkaHR0cHMlM2ElMmYlMmZ3d3cua2V1cmlnLmNvbSUyZmNvbnRlbnQlMmZibG9zc29tMjUlM2ZnY2xpZCUzZDA0ZDJjM2MxZTZlOTFkMzViMjQ1YTQyZDFmNmFiYzBkJTI2Z2Nsc3JjJTNkM3AuZHMlMjYlMjZ1dG1fc291cmNlJTNkYmluZyUyNnV0bV9tZWRpdW0lM2RjcGMtZWNvbW0lMjZ1dG1fY2FtcGFpZ24lM2RwJTNhU2VhcmNoX2N0JTNhTm9uQnJhbmRfbXQlM2FFeGFjdF9wdCUzYUJldmVyYWdlX2IlM2FLQ09NX2tjJTNhQmFnZ2VkX0JpbmclMjZ1dG1fY29udGVudCUzZGklM2FOb25lX24lM2FDb2ZmZWVfZCUzYU5vbmVfcHIlM2FOb25lX2YlM2FCYWdnZWRfY2F0JTNhTm9uZV9iciUzYU5vbmVfQnJvYWQlMjZ1dG1fdGVybSUzZGJlc3QlMjUyMGdyb3VuZCUyNTIwY29mZmVlJTI2bXNjbGtpZCUzZDA0ZDJjM2MxZTZlOTFkMzViMjQ1YTQyZDFmNmFiYzBk%26rlid%3D04d2c3c1e6e91d35b245a42d1f6abc0d&vqd=4-58389904440288688511197652614367974539&iurl=%7B1%7DIG%3D2A95305F9B7C413C9A667BD5EF56FC4C%26CID%3D18F51ADB48F260531F700F1949F6610B%26ID%3DDevEx%2C5053.1",
"snippet": "Save 25% on brewers, K-Cups® & accessories w/ code BLOSSOM25",
"title": "25% Off Keurig® Products"
},
{
"title": "72% Off K-Supreme® Smart",
"link": "https://duckduckgo.com/y.js?ad_domain=keurig.com&ad_provider=bingv7aa&ad_type=txad&click_metadata=BYouU4ad3Ntaee_2sYJLYBzSvLlSwtWC_Wfu60uFu0AjDT5mYT0LNL2pmBJNt6hAYhHbTokfpLnKfN%2DIKZWHfwcjzKxo3wCJOW_d_lsaYdMFRCd6oXPbT6kflYFIviAA.KTrE7rOkst7r2vGSnSoUNA&rut=c5e87f9ae6988ae624f541983c0b804b396d1c2247a166541d0bc69266adfebf&u3=https%3A%2F%2Fwww.bing.com%2Faclick%3Fld%3De8f37UNkS_SViPiLg0TDB3iDVUCUxv6z0eFdjfcwgP8VWKwNna1vruTTgD7qjPz6RAE%2DiCqpbVYLFiDG9%2DgN8HLBshWheJFMrJY%2DiX9a8yDPMoeOS7oZsYTph%2DlESgPK28Cymx666LWfFY8DiQcuN7e1RGaE2fzFYBOk3rST%2Dzt0vGzfi152KPyiEuIrsf1wcpj3zKjyfMfjQKeZgaJiulY6Sfd%2D8%26u%3DaHR0cHMlM2ElMmYlMmZhZC5kb3VibGVjbGljay5uZXQlMmZzZWFyY2hhZHMlMmZsaW5rJTJmY2xpY2slM2ZsaWQlM2Q0MzcwMDA4MTY1ODIyMDQxMyUyNmRzX3Nfa3dnaWQlM2Q1ODcwMDAwODg2NDcyOTA5MCUyNmRzX2FfY2lkJTNkOTc5MjcyMjI3JTI2ZHNfYV9jYWlkJTNkMjIzMzE4NDgwMTQlMjZkc19hX2FnaWQlM2QxNzk2OTcwODYxMDclMjZkc19hX2xpZCUzZGt3ZC0yNzE2NTczMjYyJTI2ZHNfeF9hZHhpZCUzZDgzNzAwMDI1MjgyNzg1MjA2JTI2ZHNfeF9hZHh0eXBlJTNkMSUyNmRzX2FfY2lkJTNkOTc5MjcyMjI3JTI2ZHNfYV9leHRpZCUzZDE1Mjk5NDEwMTQ3NyUyNmRzX2VfYWRpZCUzZDc5NzE0ODAyNjcxNDY4JTI2ZHNfZV90YXJnZXRfaWQlM2Rrd2QtNzk3MTUyMDU1NDgwNzQlM2Fsb2MtMTkwJTI2JTI2ZHNfZV9uZXR3b3JrJTNkbyUyNmRzX3VybF92JTNkMiUyNmRzX2Rlc3RfdXJsJTNkaHR0cHMlM2ElMmYlMmZ3d3cua2V1cmlnLmNvbSUyZkstU3VwcmVtZSUyNUMyJTI1QUUtU01BUlQtU2luZ2xlLVNlcnZlLUNvZmZlZS1NYWtlciUyZnAlMmZLLVN1cHJlbWUtU01BUlQtQ29mZmVlLU1ha2VyJTNmZ2NsaWQlM2Q4ODQxZDk2OTlmMzMxMjI3MDg3ZWJlODU2NmIwOTgwOSUyNmdjbHNyYyUzZDNwLmRzJTI2bXNjbGtpZCUzZDg4NDFkOTY5OWYzMzEyMjcwODdlYmU4NTY2YjA5ODA5JTI2dXRtX3NvdXJjZSUzZGJpbmclMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX2NhbXBhaWduJTNkcCUyNTNBU2VhcmNoX2N0JTI1M0FOb25CcmFuZF9tdCUyNTNBRXhhY3RfcHQlMjUzQUJldmVyYWdlX2IlMjUzQUtDT01fa2MlMjUzQUJhZ2dlZF9CaW5nJTI2dXRtX3Rlcm0lM2RiZXN0JTI1MjBncm91bmQlMjUyMGNvZmZlZSUyNnV0bV9jb250ZW50JTNkaSUyNTNBTm9uZV9uJTI1M0FDb2ZmZWVfZCUyNTNBTm9uZV9wciUyNTNBTm9uZV9mJTI1M0FCYWdnZWRfY2F0JTI1M0FOb25lX2JyJTI1M0FOb25lX0Jyb2FkJTIzQmxhY2tfY29sb3IlMjZ1dG1fc291cmNlJTNkYmluZyUyNnV0bV9tZWRpdW0lM2RjcGMtZWNvbW0lMjZ1dG1fY2FtcGFpZ24lM2RwJTNhU2VhcmNoX2N0JTNhTm9uQnJhbmRfbXQlM2FFeGFjdF9wdCUzYUJldmVyYWdlX2IlM2FLQ09NX2tjJTNhQmFnZ2VkX0JpbmclMjZ1dG1fY29udGVudCUzZGklM2FOb25lX24lM2FDb2ZmZWVfZCUzYU5vbmVfcHIlM2FOb25lX2YlM2FCYWdnZWRfY2F0JTNhTm9uZV9iciUzYU5vbmVfQnJvYWQlMjZ1dG1fdGVybSUzZGJlc3QlMjUyMGdyb3VuZCUyNTIwY29mZmVl%26rlid%3D8841d9699f331227087ebe8566b09809&vqd=4-329826019659967816817672243204904569794&iurl=%7B1%7DIG%3D2A95305F9B7C413C9A667BD5EF56FC4C%26CID%3D18F51ADB48F260531F700F1949F6610B%26ID%3DDevEx%2C5055.1",
"snippet": "Build a brewer + pods kit and get a K-Supreme® Smart brewer for $49.99"
},
"..."
]
},
{
"position": 2,
"title": "Biohacking Coffee Formula - CA-AKG Coffee for Energy",
"snippet": "Boost longevity & energy with our biohacking coffee formula. Feel younger every day. Fuel your day with a longevity-focused coffee blend. Stay sharp, stay energized.",
"sitelinks": [
{
"link": "https://duckduckgo.com/y.js?ad_domain=1775coffee.com&ad_provider=bingv7aa&ad_type=txad&click_metadata=HCSqc1sWK0tR6gGRxLaUJ3QSSVyMFQ1QZHyhkC_e_6GwTNk03v6%2DInfUY%2DNt71O7Z8WYGS6J0pYcCBR4MeLud4L5SheufrreeBoP4RrExzEo0NJqxO%2DbvqJ4%2DPCu2tIx.rMeRuCy6nsS9OOdHdap0gA&rut=590a7881c8bfa446f4c21150132bf3b425d626a2dcd4a6352c4f063a73b8a695&u3=https%3A%2F%2Fwww.bing.com%2Faclick%3Fld%3De8TprEmC%2DezuRhjcxptzgaVjVUCUxvk5tX1xfhVB5oqzd_n9v%2DA%2DOyjlcI1z%2DPpw8piCgb7mbUcR8vGPMSNWknFGMCqLRS5piEGUq_driFaHTtRbu%2DC0BhaTWXU1KVf7DIcbniqsYUoEctS93RYIbJx4KP6ojg9cGoHHcHhJrvhkioBBmajEW9nyqfK7_Mlt%2DJQ1Hsa6STSWHmrvNREoTXidikoJE%26u%3DaHR0cHMlM2ElMmYlMmYxNzc1Y29mZmVlLmNvbSUyZnByb2R1Y3RzJTJmZGFyay1yb2FzdC1ncm91bmQlM2Ztc2Nsa2lkJTNkZjZlNjIzYTc0NzAzMWVkNDQ5ODI0NDRiYmU4MDg4YmUlMjZ1dG1fc291cmNlJTNkYmluZyUyNnV0bV9tZWRpdW0lM2RjcGMlMjZ1dG1fY2FtcGFpZ24lM2RTZWFyY2glMjUyMC0lMjUyMEFudGklMjUyMEFnaW5nJTI1MjAtJTI1MjAzJTI1MkYyNCUyNTJGMjUlMjZ1dG1fdGVybSUzZEVuZXJneSUyNTIwY29mZmVlJTI2dXRtX2NvbnRlbnQlM2RBZCUyNTIwZ3JvdXAlMjUyMDE%26rlid%3Df6e623a747031ed44982444bbe8088be&vqd=4-245877522464649393574277670431513192689&iurl=%7B1%7DIG%3D2A95305F9B7C413C9A667BD5EF56FC4C%26CID%3D18F51ADB48F260531F700F1949F6610B%26ID%3DDevEx%2C5066.1"
},
{
"link": "https://duckduckgo.com/y.js?ad_domain=1775coffee.com&ad_provider=bingv7aa&ad_type=txad&click_metadata=DNZzk2_Yd1RtWYxicpKoAk6OC0IdPL1%2DJe7Y3bj6DWNZm291bItJzSmrFegfOs1aP7At1EIhMsA9vL2y1EQaKJoTtv87MWUr0eMc%2DKWjyBIusPL9cU4etbGnq_ARZrCT.nYYIw0anyjM4p3550%2Dc5gg&rut=59a3de72887440cf4781edfa57897013e1ec30a5aa3fec6a6bd71b5037440bed&u3=https%3A%2F%2Fwww.bing.com%2Faclick%3Fld%3De8i4hy5ntnyI0QQGySoORiojVUCUyAsW%2DX6Kq3rfxRNg18er2YaycC5ZsGyDAznuvt1JMXFb_71o4caPoqGcgL619jtr5yInT6sAqxdwLewtLgMbLFGUuPV0LBZk_R_X3x1NDMsoJP9OROFwB48Q4zhhrFniND0qpxgClKGMpbESwvjid4CAbJQriZn45r%2DIE6fgTsM4YNt_7aJbie6GEm8EQ5vII%26u%3DaHR0cHMlM2ElMmYlMmYxNzc1Y29mZmVlLmNvbSUyZnByb2R1Y3RzJTJmbWVkaXVtLXJvYXN0LWdyb3VuZCUzZm1zY2xraWQlM2RmZmUzMzllYjZhODIxMmM4NTZlZjVlMDc5MzAxMjc0ZCUyNnV0bV9zb3VyY2UlM2RiaW5nJTI2dXRtX21lZGl1bSUzZGNwYyUyNnV0bV9jYW1wYWlnbiUzZFNlYXJjaCUyNTIwLSUyNTIwQW50aSUyNTIwQWdpbmclMjUyMC0lMjUyMDMlMjUyRjI0JTI1MkYyNSUyNnV0bV90ZXJtJTNkRW5lcmd5JTI1MjBjb2ZmZWUlMjZ1dG1fY29udGVudCUzZEFkJTI1MjBncm91cCUyNTIwMQ%26rlid%3Dffe339eb6a8212c856ef5e079301274d&vqd=4-333104566245555919493380621391908792952&iurl=%7B1%7DIG%3D2A95305F9B7C413C9A667BD5EF56FC4C%26CID%3D18F51ADB48F260531F700F1949F6610B%26ID%3DDevEx%2C5070.1"
},
"..."
]
},
"..."
],
"organic_results": [
{
"position": 1,
"title": "The Best Coffee Shops in Portland, Oregon - Eater Portland",
"snippet": "Mar 12, 2025If Portland is anything, Portland is coffee country. It's one of the crown jewels of a region venerated for its cafes and coffee culture, one of the guiding lights of American coffee innovation. The famous coffee names in Portland are famous throughout the country. Stumptown Coffee Roasters just ..."
},
{
"position": 2,
"title": "15 Best Coffee Shops In Portland, Ranked - Tasting Table",
"snippet": "Jun 13, 2023If you're looking for the best coffee in Portland, this is for you. From espresso to custom drinks, we've ranked the best cafes so you don't have to."
},
"..."
],
"knowledge_graph": [
{
"title": "Coffee",
"description": "Coffee is a beverage brewed from roasted, ground coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans, primarily due to its caffeine content, but decaffeinated coffee is also commercially available. There are also various coffee substitutes. Typically served hot, coffee has the highest sales in the world market for hot drinks. Coffee production begins when the seeds from coffee cherries are separated to produce unroasted green coffee beans. ",
"thumbnail": "/i/748a49c3540f9ea4.jpg"
}
],
"related_searches": [
{
"query": "what is strong coffee calledwhat is strong coffee called",
"link": "?q=what%20is%20strong%20coffee%20called"
},
{
"query": "types of coffees explainedtypes of coffees explained",
"link": "?q=types%20of%20coffees%20explained"
},
"..."
],
"inline_images": [
{
"position": 1,
"link": "/?q=Coffee&iax=images&ia=images&iai=http://3.bp.blogspot.com/-U2uqPh7hw0U/UHNEoLahrPI/AAAAAAAAAv8/buuzujhKZkY/s1600/coffee.jpg",
"image": "//external-content.duckduckgo.com/iu/?u=https%3A%2F%2Ftse1.mm.bing.net%2Fth%3Fid%3DOIP.Re7WHLgpMU2E8obQUJb-TAAAAA%26pid%3DApi%26h%3D160&f=1&ipt=908338b63501a242526ab70d4e498ab05b30aef86fd52ec152a9fa631c623175&ipo=images"
},
{
"position": 2,
"link": "/?q=Coffee&iax=images&ia=images&iai=https://static.standard.co.uk/s3fs-public/thumbnails/image/2015/08/24/12/coffeecup2408a.jpg",
"image": "//external-content.duckduckgo.com/iu/?u=https%3A%2F%2Ftse1.mm.bing.net%2Fth%3Fid%3DOIP.goeZicnjtPxDhhutUyMzFAHaE8%26pid%3DApi%26h%3D160&f=1&ipt=6cb3b83dbfc618e6f22cde320c8095fbf8aa54506a0288574bb67bb3754b8f96&ipo=images"
},
{
"position": 3,
"link": "/?q=Coffee&iax=images&ia=images&iai=https://images.freeimages.com/images/large-previews/bc0/coffee-1317648.jpg",
"image": "//external-content.duckduckgo.com/iu/?u=https%3A%2F%2Ftse1.mm.bing.net%2Fth%3Fid%3DOIP.-ACVKbQLg-aRb2bVxy1jfAHaE8%26pid%3DApi%26h%3D160&f=1&ipt=43d8d01cb38e59d9cf6e302917eb3ff5240b4df6a551e0439bb79e19fe557fcd&ipo=images"
},
"..."
],
}
Response Fields
Field
Type
Description
search_metadata
object
Contains timing and status information
search_parameters
object
Contains query parameters and search context
ads
object[]
Ads
organic_results
object[]
OrganicResults
knowledge_graph
object[]
KnowledgeGraph
related_searches
object[]
RelatedSearches
inline_images
object[]
InlineImages
Error Responses
Common Errors
HTTP Status
Error Code
Description
200
400
API Key can not be empty
200
401
Param error
200
402
Api key error
200
403
Insufficient Balance
200
404
Deduction failed
200
405
Failed to record usage count
200
406
Unsupported engine
200
407
Network error
200
408
File not found
200
409
Limit param error
200
410
Build url error
200
411
Failed to QueryRecentRecord
200
412
Failed to find json
200
413
Get html error
200
414
HTML is empty
200
429
Too many request
Error Example
{
"code": 400,
"message": "API Key can not be empty"
}
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 for a full list of supported regions.
