RuntimeBuzz

API

Read-only JSON for company search, article discovery, and article links

Search companies that appear in RuntimeBuzz 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 runtimebuzz.com).

Example request

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

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

Article index (read finder)

GET /api/read-finder-index.json returns lightweight metadata for every post under content/blog/ (no markdown body). Used by the on-site read-finder widget with Fuse.js. Responses support ETag and If-None-Match (304 when unchanged).

Top-level fields: version, generatedAt, fingerprint (content change token), articles (array of path, title, excerpt, tags, tagsJoined, section, author, date).

curl -sS -D - "https://runtimebuzz.com/api/read-finder-index.json" | head