Getting Started

Canonical lets you search millions of companies using natural language. Use the REST API, Python SDK, or MCP server to integrate company search into your applications.

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: sk_your_key"

Or with Python:

from canonical_search import CanonicalClient

client = CanonicalClient(api_key="sk_your_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.