DuckDuckGo Maps API

Api Details

Endpoint GET https://serpapi.abcproxy.com/search

Description Retrieve comprehensive user profile including basic info, account status and optional permission sets.

---

Request

HTTP Request

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 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 Google Maps search. The parameter is only required if type is set to search.	123

Geographic Location

Name	Type	Required	Description	Example
bbox	string	No	Parameter defines an area where you want your q (query) to be applied. The value consists of latitude/longitude pair. The first pair marks the top left corner and the second pair marks the bottom right corner of the map area box. It has to be constructed in the next sequence: latitude_tl+ , +longitude_tl+ , +latitude_br+ , +longitude_br This will form a string that looks like this: e.g. 30.341552964181687,-97.87405344947078,30.16321730812698,-97.50702877159034 DuckDuckGo Maps uses bbox parameter as the default way to pass GPS coordinates. When unsure what the value should be, visit DuckDuckGo Maps, search for a query in a desired location, and copy a value from the URL. Parameter can't be used with lat and lon parameters.	-
lat	string	No	Defines a GPS latitude for the search origin. Parameter is required when using lon parameter.	-
lon	string	No	Defines a GPS longitude for the search origin. Parameter is required when using lat parameter.	-

Advanced Duckduckgo Maps Filters

Name	Type	Required	Description	Example
strict_bbox	string	No	Parameter defines whether you strictly want your search to follow the bbox coordinates. It can be set to 1 (strict - default), or 0 (off).	1

Serpapi Parameters

Name	Type	Required	Description	Example
engine	string	Yes	Set parameter to duckduckgo_maps to use the DuckDuckGo Maps API engine.	duckduckgo_maps
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": {
    "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",
    }
    "..."
  ],
}

Response Fields

Field	Type	Description
search_metadata	object	Contains timing and status information
search_parameters	object	Contains query parameters and search context
data.user.status	string	active/inactive/banned
data.permissions[]	array	List of permission objects

---

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

---