REST API

Search

Query the published lawn-care catalog and narrow results by topic, tag, season, kind, state, or city.

Request

Send a GET request to /api/v1/search. The q parameter accepts up to 200 characters.

curl 'https://lawncare.center/api/v1/search?q=when+to+overseed&topic=grass-types&season=fall&limit=5'

Filters

topic accepts one canonical topic ID.
tag accepts one normalized tag.
season accepts spring, summer, fall, winter, or year-round.
kind accepts article, state, or city.
state and city accept lowercase hyphenated slugs.
limit accepts 1 through 20 and defaults to 10.
cursor requests the next page using the opaque value returned by the prior response.

Call taxonomy to discover current filter values rather than hard-coding tags or locations.

Result shape

Each result includes its stable path, canonical URL, title, summary, answer, topic, tags, season, dates, citations, and relevance score. Search omits the full article body to keep responses small.

Use the returned path with the content endpoint when you need the complete Markdown body.

Pagination

Keep the filters and query unchanged when you send meta.nextCursor. A cursor is tied to the catalog version and result position. Treat it as an opaque string and stop when the response no longer includes one.

An invalid or stale cursor returns a 400 error instead of silently restarting at the first page.