OpenAPI documentation

Top 1000 Companies API

Use the paginated list endpoint to fetch all companies, or hit the matcher endpoint for semantic job alignment. The raw OpenAPI document is available at /openapi.json.

GET /api/companies

Paginated listing with filters and keyword search.

GET /api/companies?limit=200&offset=0&q=exchange

Query parameters

GET /api/match

Semantic matching from a job title or description.

GET /api/match?job=compliance%20analyst%20crypto%20exchange&limit=10

Query parameters

How matching works

Matching uses weighted keyword scoring against company name, category, and region plus a lightweight synonym expansion (web3, blockchain, defi, etc.).

For more advanced semantic matching, you can replace the scoring logic inapp/lib/companies.ts with vector search or an embedding model.