# Find Bing Maps businesses or look up a single listing

Returns the Bing Maps businesses that match a search, with address, rating, phone and website. Use it to find local businesses on Bing.

Tool `bing.maps.search` on Bing. Contract version 1, released 2026-10-27.

## Example call

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

cURL:

```bash
curl https://api.voxoria.ai/v1/tools/bing.maps.search/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"coffee shops in austin"}}'
```

Python:

```python
import os

import httpx

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

TypeScript:

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

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "bing.maps.search",
    "input": {
      "query": "coffee shops in austin"
    }
  }
}
```

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | Yes |  | What to look for on the map, such as "coffee shops in Austin, TX". 1 to 2048 characters. |
| `page` | integer | No | `1` | Page of results, 10 to a page. From 1 to 1001. |

## 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.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `position` | integer | Yes | Rank among the places found, starting at 1. |
| `title` | string | Yes | Name of the business or place. |
| `address` | string | No |  |
| `latitude` | number | No |  |
| `longitude` | number | No |  |
| `rating` | number | No | Average review rating, out of 5. |
| `review_count` | integer | No |  |
| `rating_source` | string | No | Name of the site the rating and review count come from, such as "Yelp". |
| `category` | string | No | Kind of business, such as "Cafe". |
| `phone` | string | No | Phone number as Bing shows it. |
| `website` | string | No | Address of the place's own website. |
| `image_url` | string | No | Address of the place's thumbnail image. |
| `url` | string | No | Address of the place on Bing Maps. |
| `place_id` | string | No | Bing's ID of the place, such as "YNDC222D0D9C80FD19". |

## Example output

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

```json
{
  "results": [
    {
      "position": 1,
      "title": "Mozart's Coffee Roasters",
      "address": "3825 Lake Austin Blvd, Austin, TX 78703",
      "latitude": 30.295475006103516,
      "longitude": -97.78395080566406,
      "rating": 4,
      "review_count": 2159,
      "rating_source": "Yelp",
      "category": "Cafe",
      "phone": "(512) 477-2900",
      "website": "https://mozartscoffee.com/",
      "image_url": "https://www.bing.com/th?id=OLC.ljpSTWdC+MIzIA480x360&pid=Local",
      "url": "https://www.bing.com/maps?q=Mozart%27s+Coffee+Roasters&filters=local_ypid%3A%22YNDC222D0D9C80FD19%22",
      "place_id": "YNDC222D0D9C80FD19"
    },
    {
      "position": 2,
      "title": "Summer Moon Coffee (South 1st)",
      "address": "3115 S 1st St #1B, Austin, TX 78704",
      "latitude": 30.23322296142578,
      "longitude": -97.76485443115234,
      "rating": 4,
      "review_count": 1112,
      "rating_source": "Yelp",
      "category": "Cafe",
      "phone": "(512) 804-1665",
      "website": "https://locations.summermooncoffee.com/locations/south-first-austin/",
      "image_url": "https://www.bing.com/th?id=OLC.NOT8+v3FMNz0nQ480x360&pid=Local",
      "url": "https://www.bing.com/maps?q=Summer+Moon+Coffee+%28South+1st%29&filters=local_ypid%3A%22YNCB24A91E7018E57E%22",
      "place_id": "YNCB24A91E7018E57E"
    },
    {
      "position": 3,
      "title": "Bennu Coffee",
      "address": "2001 E Martin Luther King Jr Blvd, Austin, TX 78702",
      "latitude": 30.279802322387695,
      "longitude": -97.71961975097656,
      "rating": 4,
      "review_count": 812,
      "rating_source": "Yelp",
      "category": "Cafe",
      "phone": "(512) 478-4700",
      "website": "http://www.bennucoffee.com/",
      "image_url": "https://www.bing.com/th?id=OLC.bLf+TsqXPy1VZg480x360&pid=Local",
      "url": "https://www.bing.com/maps?q=Bennu+Coffee&filters=local_ypid%3A%22YNC063B9761760EF2%22",
      "place_id": "YNC063B9761760EF2"
    }
  ]
}
```