TopMagpie

Public API

TopMagpie exposes a read-only JSON API for developers and AI tools. All responses include CORS headers, cache-friendly headers, and an affiliate disclosure. Content is editorial — we do not publish live Amazon prices or lab test claims via the API.

Base URL

https://www.topmagpie.com/api/v1

Endpoints

  • GET /api/v1 — discovery and documentation links
  • GET /api/v1/openapi.json — OpenAPI 3 specification
  • GET /api/v1/guides — list published guides (?category= optional)
  • GET /api/v1/guides/[slug] — full guide detail
  • GET /api/v1/articles — winter advice articles
  • GET /api/v1/categories — categories with guide counts

Example requests

API discovery

curl -s https://www.topmagpie.com/api/v1 | jq .

OpenAPI specification

curl -s https://www.topmagpie.com/api/v1/openapi.json | jq .info

List guides

curl -s https://www.topmagpie.com/api/v1/guides | jq '.guides | length'

Filter guides by category

curl -s "https://www.topmagpie.com/api/v1/guides?category=home-energy" | jq '.guides[0].title'

Guide detail

curl -s https://www.topmagpie.com/api/v1/guides/best-draught-excluders-uk | jq '.guide.quickAnswer'

List articles

curl -s https://www.topmagpie.com/api/v1/articles | jq '.count'

List categories

curl -s https://www.topmagpie.com/api/v1/categories | jq '.categories'

Attribution

Please cite the canonical guide URL when quoting recommendations. See also llms.txt and llms-full.txt for AI-oriented indexing.

Download OpenAPI JSON →