Skip to main content

​
1. Overview

The Company Search API resolves a company name, website domain, or UUID into a structured company record. Its primary purpose is to look up the uuid needed by the other APIs when you only have a company name to start with. This is a free endpoint — it does not consume API credits. Endpoint 
GET https://api.akta.pro/api/v1/company/search
Pass a single name query parameter. The backend automatically detects whether the input is a company name, website domain or UUID and resolves it accordingly.

​
2. Authentication

All requests must include an API key in the x-api-key HTTP header. 
x-api-key: <YOUR_API_KEY>
Never expose your API key in client-side code, browser requests, or public repositories. A missing or invalid key returns 401 Unauthorized.

​
3. Request Reference

ParameterTypeRequiredDescription
querystringRequiredCompany name (e.g. "Canva"), website domain (e.g. "canva.com"), or UUID (e.g. "00000jw-canva"). The API automatically identifies the input type and resolves it.
Example requests: 
curl --location 'https://api.akta.pro/api/v1/company/search?query=Canva' \
  --header 'x-api-key: <YOUR_API_KEY>'

​
4. Response

​
Response envelope

{
  "data": [
    {
      "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Canva",
      "website": "https://canva.com",
      "product_category": "SaaS",
      "company_status": "private"
    }
  ],
  "credits_consumed": 0.00
}
FieldTypeDescription
dataobject[]Array of matching company objects. Empty array [] when no results are found.
credits_consumedfloatAlways 0.00 — this is a free endpoint.

​
Company object

FieldTypeDescription
uuidstring (UUID)Unique Akta identifier for the company. Pass this as the company parameter in the Enrichment and News APIs.
namestringLegal or registered company name.
websitestringPrimary website URL, normalised with no trailing slash.
product_categorystringPrimary product or service category (e.g. "SaaS", "FinTech", "Healthcare").
company_statusstringPublic market status: "public", "private", "acquired", "delisted", or "unknown".
When no companies match the query, the API returns 204 No Content with an empty data array.

​
5. Using the UUID in other APIs

Once you have the uuid, pass it as the company field in downstream API calls: 
import requests

HEADERS = {"x-api-key": "<YOUR_API_KEY>"}

# Step 1: Search for the company
search = requests.get(
    "https://api.akta.pro/api/v1/company/search",
    headers=HEADERS,
    params={"query": "Canva"}
)
uuid = search.json()["data"][0]["uuid"]

# Step 2: Use the UUID in Company Enrichment
enrich = requests.post(
    "https://api.akta.pro/api/v1/company/enrichment",
    headers={**HEADERS, "Content-Type": "application/json"},
    json={"company": uuid, "sections": ["firmographics", "funding"]}
)
print(enrich.json()["data"]["firmographics"]["name"])

# Or use it in the News API
news = requests.get(
    "https://api.akta.pro/api/v1/news",
    headers=HEADERS,
    params={"company": uuid, "limit": 10}
)
print(f"Found {news.json()['total']} articles")