DuckDuckGo 地圖 API

API 詳情

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

說明

我們的 DuckDuckGo 地圖 API 允許您從 DuckDuckGo 地圖頁面抓取結果。此 API 可透過以下端點存取：/search?engine=duckduckgo_maps。

使用者可以使用 GET 請求查詢以下網址：https://serpapi.abcproxy.com/search?engine=duckduckgo_maps。請前往 工作臺 查看即時互動演示。

---

請求方式

HTTP 請求範例

cURL

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

Python

import requests

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

Node.js

const axios = require('axios');

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

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

HTTP

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

PHP

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

Golang

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_maps")
    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))
}

C#

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_maps";
        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());
    }
}

Java

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_maps" +
            "&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 Maps 支援的任何搜尋語法（若 type=search 時為必填）	Coffee

地理位置

參數名稱	類型	必填項	說明	範例
bbox	字符串	否	指定查詢範圍的經緯度邊界框，格式為：緯度_左上,經度_左上,緯度_右下,經度_右下 例如：30.341552,-97.874053,30.163217,-97.507028。也可從 DuckDuckGo Maps 網址中取得 bbox 值。 不能與 lat / lon 同時使用。	-
lat	字符串	否	查詢中心點的緯度。若使用需搭配 lon	-
lon	字符串	否	查詢中心點的經度。若使用需搭配 lat	-

進階 DuckDuckGo 地圖過濾器

參數名稱	類型	必填項	說明	範例
strict_bbox	字符串	否	是否強制查詢僅限於指定的 bbox 範圍：1（是，預設）、0（否）	1

SerpApi 專屬參數

參數名稱	類型	必填項	說明	範例
engine	字符串	是	設為 duckduckgo_maps 使用 DuckDuckGo 地圖引擎	duckduckgo_maps
no_cache	布爾值	否	是否跳過快取重新抓取結果，預設為 false	trueorfalse
api_key	字符串	是	指定要使用的 SerpApi 私密金鑰	-

---

響應

成功回應（HTTP 200）

響應機构

{
    "search_metadata": {
    "created_at": "2025-04-02 17:00:01",
    "google_news_url": "https://duckduckgo.com?iaxm=maps&q=Coffee",
    "raw_html_file": "https://webserp.abcproxy.com/files/fe5699f8278f0728/b58e9a71-7c71-4c91-8d68-379d576f348f.html",
    "xray_html_file": "https://webserp.abcproxy.com/files/fe5699f8278f0728/b58e9a71-7c71-4c91-8d68-379d576f348f.xray",
    "total_time_taken": "34.5388",
    "id": "b58e9a71-7c71-4c91-8d68-379d576f348f",
    "json_endpoint": "https://webserp.abcproxy.com/files/fe5699f8278f0728/b58e9a71-7c71-4c91-8d68-379d576f348f.json"
  }
  "search_parameters": {
    "engine": "duckduckgo_maps",
    "no_cache": true,
    "api_key": "YOUR_API_KEY",
    "q": "Coffee"
  },
  "local_results": [
    {
      "position": 1
      "title" : "Cenote"
      "address":"1010 E Cesar Chavez St, Austin, TX 78702",
    },
    {
      "position": 2
      "title" : "Bennu Coffee",
      "address":"2001 E Martin Luther King Jr Blvd, Austin, TX 78702",
    },
    {
      "position": 3
      "title" : "Flat Track Coffee",
      "address":"913 E Cesar Chavez St, Austin, TX 78702-4205",
    }
    "..."
  ],
}

響應欄位

欄位名稱	類型	說明
search_metadata	對象	查詢元資料
search_parameters	對象	實際查詢參數
data.user.status	字符串	使用者帳號狀態：active（啟用）、inactive（停用）、banned（封鎖）
data.permissions[]	對象數組	使用者的權限清單，每項為一個權限物件

---

錯誤回應

常見錯誤碼與說明

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"
}

---