Search API

The Search endpoint provides full-text search across company names, descriptions, and metadata with faceted filtering.

Search companies

Terminal

GET /api/v1/search

Query parameters

Parameter	Type	Description
`q`	string	Search query (required)
`facets`	string	Comma-separated facet fields: `sector`, `stage`, `country`
`filters`	string	Facet filters in `field:value` format
`limit`	number	Results per page (default: 20, max: 100)
`offset`	number	Pagination offset

Example

Terminal

curl "https://claradb.com/api/v1/search?q=computer+vision&facets=sector,stage" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

JSON

{
  "data": [
    {
      "id": "comp_xyz789",
      "name": "VisionCorp",
      "slug": "visioncorp",
      "sector": "computer-vision",
      "momentum_score": 72.1,
      "highlight": "Leading <em>computer vision</em> platform for..."
    }
  ],
  "facets": {
    "sector": [
      { "value": "computer-vision", "count": 48 },
      { "value": "multimodal", "count": 23 }
    ],
    "stage": [
      { "value": "series-a", "count": 31 },
      { "value": "seed", "count": 19 }
    ]
  },
  "pagination": {
    "total": 71,
    "limit": 20,
    "offset": 0
  }
}