Search in the app. Build with the API.

Send natural-language queries, receive structured, evidence-backed companies. The same Canonical search engine, accessible inside your product, internal tools, or research workflow, through the REST API, Python SDK, or MCP server.

REST API

Search companies with a simple HTTP request. Supports JSON and SSE streaming.

Python SDK

Type-safe client with sync and async support. Install with pip.

MCP Server

Give AI assistants like Claude, Cursor, and Windsurf access to company search.

1. Get an API key

2. Make your first search

curl "https://trycanonical.ai/api/v1/search?q=AI+healthcare+startups&top_k=5" \
  -H "x-api-key: YOUR_API_KEY"

Or with Python:

from canonical_search import CanonicalClient

client = CanonicalClient(api_key="YOUR_API_KEY")
results = client.search("AI healthcare startups")

for company in results.results:
    print(f"{company.name} — {company.domain}")

3. Understand the response

{
  "results": [
    {
      "id": 12345,
      "name": "Acme Health AI",
      "website": "https://acmehealthai.com",
      "logo_url": "https://logo.clearbit.com/acmehealthai.com",
      "domain": "acmehealthai.com",
      "description": "AI-powered diagnostic platform for healthcare providers..."
    }
  ],
  "count": 5,
  "query": "AI healthcare startups",
  "credits_used": 1,
  "credits_remaining": 999
}

Next steps

REST API Reference — Full endpoint documentation, authentication, rate limits, and error handling.
Python SDK — Install, configure, and use the type-safe client.
MCP Server — Set up company search in Claude Desktop, Cursor, or Windsurf.
Integrations — Use Canonical with LangChain, AutoGen, CrewAI, and Agno.