---
title: "Search By Bounds"
method: POST
path: "/api/map-search/bounds"
tags: ["map-search"]
---

# Search By Bounds

`POST /api/map-search/bounds`

## Request

- Base URL: `https://ai.tacostreetlocating.com`
- URL: `https://ai.tacostreetlocating.com/api/map-search/bounds`
- Auth: none declared

Search apartments within visible map bounds.
Used for Airbnb-style map exploration.

Returns apartments that fall within the lat/lng bounding box,
with optional filters applied.

## Request body

- MapBoundsSearch: Search parameters based on visible map bounds
  - `north` number, required
  - `south` number, required
  - `east` number, required
  - `west` number, required
  - `walkability_tiers` string[], nullable
  - `max_budget` integer, nullable
  - `min_rating` number, nullable
  - `pet_friendly` boolean
  - `home_types` string[], nullable
  - `has_garage` boolean
  - `has_yard` boolean
  - `bedrooms` string[], nullable
  - `amenities` string[], nullable
  - `limit` integer

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tacostreetlocating/apis/taco-street-locating-public-api.md) · [All operations](https://skmtc.dev/tacostreetlocating/apis/taco-street-locating-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tacostreetlocating/apis/taco-street-locating-public-api/revisions/e09e16f653cc?raw)