Find DuckDuckGo Maps places inside a map viewport

POST/v1/tools/duckduckgo.maps.search/callsNeeds an API key

Returns the DuckDuckGo Maps places that match a search around a point, with address, rating and category. Use it to find local places near given coordinates.

Tool duckduckgo.maps.search on DuckDuckGo. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystringRequired

What to look for on the map, a name or a kind of place, such as "coffee shops".

1 to 500 characters.

latitudenumberRequired

Latitude of the center of the map to search, from -90 to 90.

From -90 to 90.

longitudenumberRequired

Longitude of the center of the map to search, from -180 to 180.

From -180 to 180.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`results`

A list of rows. Always present, possibly empty.

positionintegerRequired

Rank among the places found, starting at 1.

titlestringRequired

Name of the business or place.

addressstring

latitudenumber

longitudenumber

ratingnumber

Average review rating, out of 5.

review_countinteger

price_rangestring

Price level as DuckDuckGo shows it, such as "$$". Not parsed.

price_levelinteger

Price level from 1, least expensive, to 4, most expensive.

categorystring

Kind of business, such as "Coffee & tea".

curl https://api.voxoria.ai/v1/tools/duckduckgo.maps.search/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"coffee shops","latitude":30.2672,"longitude":-97.7431}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/duckduckgo.maps.search/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {
            "query": "coffee shops",
            "latitude": 30.2672,
            "longitude": -97.7431,
        },
    },
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/duckduckgo.maps.search/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {
      "query": "coffee shops",
      "latitude": 30.2672,
      "longitude": -97.7431,
    },
  }),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "duckduckgo.maps.search",
    "input": {
      "query": "coffee shops",
      "latitude": 30.2672,
      "longitude": -97.7431
    }
  }
}

200 OKoutputapplication/json

{
  "results": [
    {
      "position": 1,
      "title": "Desnudo Coffee",
      "address": "111 Congress Ave, Austin, TX 78701",
      "latitude": 30.2641013,
      "longitude": -97.743957,
      "rating": 4.5,
      "review_count": 119,
      "price_range": null,
      "price_level": null,
      "category": "Coffee roasteries"
    },
    {
      "position": 2,
      "title": "Sweetwaters Coffee & Tea",
      "address": "316 W 12th St, Austin, TX 78701",
      "latitude": 30.2750702,
      "longitude": -97.7438217,
      "rating": 4.5,
      "review_count": 96,
      "price_range": null,
      "price_level": null,
      "category": "Coffee & tea"
    },
    {
      "position": 3,
      "title": "Idlewild Coffee",
      "address": "824 W 12th St, Ste A, Austin, TX 78701",
      "latitude": 30.276599,
      "longitude": -97.7495563,
      "rating": 4.5,
      "review_count": 57,
      "price_range": "$$",
      "price_level": 2,
      "category": "Coffee & tea"
    }
  ]
}

The output of a real call, each list cut to 3 items.