API

Search companies that appear in BevWire article frontmatter. Each result includes matching articles with titles and canonical site URLs.

Endpoint

GET /api/companies/search

Query parameters

• q — Search text. Every whitespace-separated token must appear in the company name or URL slug (case-insensitive). An empty q returns { "query": "", "companies": [] }.
• limit — Optional. Maximum number of companies in the response (default 200, capped at 500).

Response

JSON with application/json; charset=utf-8. Top-level fields:

• query — The trimmed search string you sent.
• companies — Array of objects: slug, name, articleCount, and articles (each article has title, path, and absolute url on bevwire.com).

Example request

curl -sS "https://bevwire.com/api/companies/search?q=sierra&limit=3"

Replace the host when testing against a local server (for example http://localhost:3082).