AI-powered company search

POST

/v1/companies/ai-search

Natural-language search powered by an AI ranker. Better for fuzzy queries like
"Geneva watch manufacturers" than the exact-match search endpoint.

offset is capped at 500 to prevent bulk enumeration; use a more specific query to narrow results.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Example

{
    "query": "Geneva luxury watchmakers",
    "limit": 20,
    "offset": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/companies/ai-search' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "query": "Geneva luxury watchmakers",
    "limit": 20,
    "offset": 0
}'

Responses

🟢200

application/json

Paginated companies, ranked by AI relevance.

Bodyapplication/json

Example

{
    "success": true,
    "data": {
        "total": 250,
        "items": [
            {
                "id": 12345,
                "name": "Nestlé S.A.",
                "uid": "CHE-100.063.197",
                "status": "active",
                "legalform": "Aktiengesellschaft",
                "registerdate": "1866-01-01",
                "address": "string",
                "location": "Vevey",
                "canton": "VD",
                "slug": "nestle-sa"
            }
        ]
    }
}

🟠400BadRequest

🟠401Unauthorized

🟠402PaymentRequired

🟠429TooManyRequests

🔴502UpstreamError

Modified at 2026-05-25 11:54:46

Search companies

Get company by ID