DuckDuckGo 搜尋 API

最后更新于6天前

DuckDuckGo 搜尋 API

API 詳情

請求端點 GET https://serpapi.abcproxy.com/search

說明
我們的 DuckDuckGo 搜尋引擎結果 API 允許您從DuckDuckGo 搜尋引擎結果頁面抓取結果。此 API 可透過以下端點存取：/search?engine=duckduckgo。
使用者可以使用 GET 請求查詢以下網址：https://serpapi.abcproxy.com/search?engine=duckduckgo。請前往查看即時互動演示。

請求方式

HTTP 請求範例

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=duckduckgo" \
  -d "q=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

import requests

params = {
    "engine": "duckduckgo",
    "q": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

const axios = require('axios');

const params = {
  engine: "duckduckgo",
  q: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

GET /search?engine=duckduckgo&q=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'duckduckgo',
        'q' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "duckduckgo")
    q.Add("q", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

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";
        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" +
            "&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 參數說明

搜尋參數

參數名稱

類型

必填項

說明

範例

q

字符串

是

搜尋關鍵字，可使用 DuckDuckGo 語法如 site:、intitle: 等

Coffee

地區與語言設定

參數名稱

類型

必填項

說明

範例

kl

字符串

否

en

進階過濾器

參數名稱

類型

必填項

說明

範例

safe

字符串

否

成人內容過濾等級：1 嚴格，-1 中等（預設），-2 不過濾

-1

df

字符串

否

日期過濾：d（一天內）、w（一週內）、m（一個月內）、y（一年內）或 2021-06-15..2021-06-16

分頁參數

參數名稱

類型

必填項

說明

示例

start

字符串

否

分页偏移量，跳过指定数量的结果。首页返回约 26~30 个结果，分页后返回 50 个。

SerpApi 專屬參數

參數名稱

類型

必填項

說明

示例

engine

字符串

是

指定為 duckduckgo 啟用 DuckDuckGo 搜尋引擎

duckduckgo

no_cache

布爾值

否

是否強制跳過快取（預設為 false）。快取一小時有效，使用快取不計入查詢次數

trueorfalse

api_key

字符串

是

指定要使用的 SerpApi 私密金鑰

響應

成功回應（HTTP 200）

響應機构

{
    "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"
        }
		"..."
      ]
    }
  ],
  "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."
    },
    {
      "position": 3,
      "title": "10 Best Coffee Shops in Portland 2025: Cozy & Hip Cafés",
      "snippet": "4 days agoPortland is one of the hotbeds of specialty coffee, so there are lots of great coffee shops! Here are our favorite coffee shops in Portland..."
    }
    "..."
  ],
  "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"
    }
    "..."
  ],
}

響應欄位

欄位名稱

類型

說明

search_metadata

對象

搜尋的元資訊，如 ID 與時間

search_parameters

對象

實際使用的查詢參數

ads

對象數組

廣告列表

organic_results

對象數組

自然搜尋結果

knowledge_graph

對象數組

知識圖譜資訊

related_searches

對象數組

相關搜尋建議

inline_images

對象數組

搜尋結果圖片

錯誤回應

常見錯誤碼與說明

HTTP 狀態碼

錯誤碼

說明

200

400

API 金鑰不能為空

200

401

參數錯誤

200

402

API 金鑰錯誤

200

403

餘額不足

200

404

扣款失敗

200

405

記錄使用次數失敗

200

406

不支援的搜尋引擎

200

407

網路錯誤

200

408

找不到檔案

200

409

限制參數錯誤

200

410

建立 URL 錯誤

200

411

查詢歷史記錄失敗

200

412

找不到 JSON 結果

200

413

擷取 HTML 失敗

200

414

HTML 為空

200

429

請求次數過多

錯誤回應範例

{
  "code": 400,
  "message": "API Key can not be empty"
}

上一页DuckDuckGo 下一页DuckDuckGo 新聞 API

最后更新于6天前

API 詳情

請求端點 GET https://serpapi.abcproxy.com/search

說明
我們的 DuckDuckGo 搜尋引擎結果 API 允許您從DuckDuckGo 搜尋引擎結果頁面抓取結果。此 API 可透過以下端點存取：/search?engine=duckduckgo。
使用者可以使用 GET 請求查詢以下網址：https://serpapi.abcproxy.com/search?engine=duckduckgo。請前往查看即時互動演示。

請求方式

HTTP 請求範例

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=duckduckgo" \
  -d "q=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

import requests

params = {
    "engine": "duckduckgo",
    "q": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

const axios = require('axios');

const params = {
  engine: "duckduckgo",
  q: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

GET /search?engine=duckduckgo&q=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'duckduckgo',
        'q' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "duckduckgo")
    q.Add("q", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

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";
        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" +
            "&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 參數說明

搜尋參數

參數名稱

類型

必填項

說明

範例

q

字符串

是

搜尋關鍵字，可使用 DuckDuckGo 語法如 site:、intitle: 等

Coffee

地區與語言設定

參數名稱

類型

必填項

說明

範例

kl

字符串

否

地區語言碼，例如 us-en（美國英文）、fr-fr（法文）。詳見

en

進階過濾器

參數名稱

類型

必填項

說明

範例

safe

字符串

否

成人內容過濾等級：1 嚴格，-1 中等（預設），-2 不過濾

-1

df

字符串

否

日期過濾：d（一天內）、w（一週內）、m（一個月內）、y（一年內）或 2021-06-15..2021-06-16

分頁參數

參數名稱

類型

必填項

說明

示例

start

字符串

否

分页偏移量，跳过指定数量的结果。首页返回约 26~30 个结果，分页后返回 50 个。

SerpApi 專屬參數

參數名稱

類型

必填項

說明

示例

engine

字符串

是

指定為 duckduckgo 啟用 DuckDuckGo 搜尋引擎

duckduckgo

no_cache

布爾值

否

是否強制跳過快取（預設為 false）。快取一小時有效，使用快取不計入查詢次數

trueorfalse

api_key

字符串

是

指定要使用的 SerpApi 私密金鑰

響應

成功回應（HTTP 200）

響應機构

{
    "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"
        }
		"..."
      ]
    }
  ],
  "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."
    },
    {
      "position": 3,
      "title": "10 Best Coffee Shops in Portland 2025: Cozy & Hip Cafés",
      "snippet": "4 days agoPortland is one of the hotbeds of specialty coffee, so there are lots of great coffee shops! Here are our favorite coffee shops in Portland..."
    }
    "..."
  ],
  "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"
    }
    "..."
  ],
}

響應欄位

欄位名稱

類型

說明

search_metadata

對象

搜尋的元資訊，如 ID 與時間

search_parameters

對象

實際使用的查詢參數

ads

對象數組

廣告列表

organic_results

對象數組

自然搜尋結果

knowledge_graph

對象數組

知識圖譜資訊

related_searches

對象數組

相關搜尋建議

inline_images

對象數組

搜尋結果圖片

錯誤回應

常見錯誤碼與說明

HTTP 狀態碼

錯誤碼

說明

200

400

API 金鑰不能為空

200

401

參數錯誤

200

402

API 金鑰錯誤

200

403

餘額不足

200

404

扣款失敗

200

405

記錄使用次數失敗

200

406

不支援的搜尋引擎

200

407

網路錯誤

200

408

找不到檔案

200

409

限制參數錯誤

200

410

建立 URL 錯誤

200

411

查詢歷史記錄失敗

200

412

找不到 JSON 結果

200

413

擷取 HTML 失敗

200

414

HTML 為空

200

429

請求次數過多

錯誤回應範例

{
  "code": 400,
  "message": "API Key can not be empty"
}