---
title: "Search listings near a location"
method: GET
path: "/api/mcp/by-location"
tags: ["MCP API"]
---

# Search listings near a location

`GET /api/mcp/by-location`

## Request

- Base URL: `https://www.cyclesite.co.uk`
- URL: `https://www.cyclesite.co.uk/api/mcp/by-location`
- Auth: none required

Active listings within a radius of a UK lat/lng (max 50 miles, 10 results). Returns town-level location only — never the precise listing coordinates. lat/lng are clamped to a UK bounding box. No authentication required.

## Query parameters

- `lat` number, nullable: Latitude (UK box: 49.5-61.0)
- `lng` number, nullable: Longitude (UK box: -8.5-2.0)
- `radiusMiles` number, nullable: Radius in miles (1-50, default 25)
- `category` string
- `maxPrice` number, nullable: Maximum price in GBP
- `limit` number, nullable: Max results (1-10, default 5)

## Response `200`

Nearby listings

- object
  - `attribution` string, required
  - `center` object, required
    - `lat` number, required
    - `lng` number, required
  - `listings` object[], required
    - `brand` string, nullable, required
    - `city` string, nullable, required
    - `condition` string, nullable, required
    - `distanceMiles` number, required
    - `model` string, nullable, required
    - `priceGbp` number, required
    - `title` string, required
    - `url` string, nullable, required
  - `radiusMiles` number, required
  - `resultsCount` number, required

## Other responses

- `400`: lat/lng outside the UK bounding box
- `429`: Rate limited

---

[API](https://skmtc.dev/cyclesite/apis/cyclesite-public-api.md) · [All operations](https://skmtc.dev/cyclesite/apis/cyclesite-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cyclesite/apis/cyclesite-public-api/revisions/a0dc604cce71?raw)