Content and taxonomy

Fetch a document

Pass a path returned by search to /api/v1/content/{path}:

curl https://lawncare.center/api/v1/content/articles/how-to-overseed-lawn

Supported path forms are:

articles/{slug}
states/{state}/{slug}
cities/{city}/{slug}

The response includes normalized metadata, the full Markdown body, citations, and location data when applicable. A missing or unpublished path returns 404.

List taxonomy values

Request the current filter vocabulary and document counts:

curl https://lawncare.center/api/v1/taxonomy

The response groups values under topics, tags, seasons, kinds, states, and cities. Each value has an ID, display label, and count.

Canonical topics

The seven topic IDs are seasonal-care, lawn-health, fertilization, weed-control, lawn-problems, equipment, and grass-types.

Tags are normalized when the catalog loads. The source Markdown remains unchanged. Use the taxonomy response as the current authority because new articles can add tags and locations.

Build a retrieval flow

1. List a taxonomy facet if you need a valid filter value.
2. Search with the user's question and the narrowest relevant filters.
3. Fetch the chosen result by its exact path.
4. Show the canonical URL and preserve citations in the final answer.