QHSEtech Public API

Base URL

https://nypdfolwwyubfqqljmxj.functions.supabase.co/public-api

All requests require an Authorization: Bearer YOUR_API_KEY header. Generate a key below.

Without a key

AI assistants can use the read-only MCP server (Model Context Protocol, streamable HTTP) with no key. It searches the profiles, returns one profile and lists and returns the articles. Every result carries the page's URL, and each profile, search result and full article also carries a citation line.

https://nypdfolwwyubfqqljmxj.supabase.co/functions/v1/mcp

The catalog is also a file, /data/software.json, and the study CSVs are on the datasets page. QHSEtech-authored data is CC BY 4.0.

Endpoints

curl https://nypdfolwwyubfqqljmxj.functions.supabase.co/public-api/v1/software?limit=5 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "example-product",
      "name": "Example Product",
      "tagline": "...",
      "category": "QHSE Platform",
      "rating": null,
      "review_count": 0,
      "website": "https://...",
      ...
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "total": 212 }
}

curl https://nypdfolwwyubfqqljmxj.functions.supabase.co/public-api/v1/software/tekmon \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://nypdfolwwyubfqqljmxj.functions.supabase.co/public-api/v1/categories \
  -H "Authorization: Bearer YOUR_API_KEY"

Code samples

Same request — list software products — across five languages. Click the language tab and copy.

curl https://nypdfolwwyubfqqljmxj.functions.supabase.co/public-api/v1/software?limit=5 \
  -H "Authorization: Bearer YOUR_API_KEY"

Official SDKs

Drop-in single-file clients for TypeScript and Python. Same API surface, fully typed, minimal dependencies.

Install

The SDKs are not published to npm or PyPI yet, so there is no package to install. Today the supported way is to download the single-file client and keep it in your project.

curl -O https://qhsetech.com/api-docs/sdk/qhsetech.ts

Or use the download buttons above: qhsetech.ts · qhsetech.py. Place the file next to your code; the examples below import it from there.

Quick start

import { QhseTechClient, QhseTechApiError } from "./qhsetech";

const client = new QhseTechClient({
  apiKey: process.env.QHSE_API_KEY!, // qhse_live_*
});

// List products
const { data, pagination } = await client.software.list({
  category: "Incident Management",
  limit: 10,
});
console.log(`${pagination?.total} products total`);

// Single product
const { data: product } = await client.software.get("tekmon");

// Keyword search: name matches first, then A to Z (not a ranking)
const { data: results } = await client.search.products({
  q: "permit to work for confined spaces",
  limit: 5,
});

// Typed error handling
try {
  await client.software.get("does-not-exist");
} catch (e) {
  if (e instanceof QhseTechApiError) {
    console.error(e.code, e.status, e.requestId);
  }
}

Available methods

Errors & status codes