---
title: "Search buying guides"
method: GET
path: "/api/mcp/buying-guide"
tags: ["MCP API"]
---

# Search buying guides

`GET /api/mcp/buying-guide`

## Request

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

Search published buying guides by keyword and return matching guides with excerpt, difficulty and reading time so an assistant can answer directly and cite the guide URL. No authentication required.

## Query parameters

- `query` string, required: Search terms (2-100 chars)
- `limit` number, nullable: Max results (1-5, default 3)

## Response `200`

Matching guides

- object
  - `attribution` string, required
  - `guides` object[], required
    - `category` string, nullable, required
    - `difficulty` string, nullable, required
    - `excerpt` string, nullable, required
    - `readingTimeMinutes` number, nullable, required
    - `title` string, required
    - `url` string, required
  - `query` string, required
  - `resultsCount` number, required

## Other responses

- `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)