---
title: "Find similar listings"
method: GET
path: "/api/mcp/similar/{slug}"
tags: ["MCP API"]
---

# Find similar listings

`GET /api/mcp/similar/{slug}`

## Request

- Base URL: `https://www.cyclesite.co.uk`
- URL: `https://www.cyclesite.co.uk/api/mcp/similar/{slug}`
- Auth: none required

Up to 5 listings similar to the given one (same category, ±25% price, ranked by brand/frame-size match and price proximity). No authentication required.

## Path parameters

- `slug` string, required: Source listing URL slug

## Response `200`

Similar listings

- object
  - `attribution` string, required
  - `listings` object[], required
    - `brand` string, nullable, required
    - `city` string, nullable, required
    - `condition` string, nullable, required
    - `delivery` string, nullable, required
    - `ebikeBatteryWh` number, nullable
    - `ebikeMotor` string, nullable
    - `frameMaterial` string, nullable, required
    - `frameSize` string, nullable, required
    - `groupset` string, nullable, required
    - `imageUrl` string, nullable, required
    - `isEbike` boolean, required
    - `model` string, nullable, required
    - `negotiable` boolean, nullable, required
    - `offer` object, required: UCP/Schema.org-shaped offer signal agents can read deterministically
      - `availability` 'in_stock', required
      - `itemCondition` 'new' | 'used', required
      - `price` number, nullable, required
      - `priceCurrency` 'GBP', required
    - `priceGbp` number, nullable, required
    - `title` string, required
    - `url` string, nullable, required
    - `wheelSize` string, nullable, required
    - `year` number, nullable, required
  - `resultsCount` number, required
  - `source` object, required
    - `brand` string, nullable, required
    - `category` string, nullable, required
    - `model` string, nullable, required
    - `priceGbp` number, required

## Other responses

- `400`: Invalid slug
- `404`: Source listing not found
- `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)