Company Search

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 so 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.

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.

Request Reference

Parameter	Type	Required	Description
`query`	string	Required	Company 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>'

import requests

response = requests.get(
    "https://api.akta.pro/api/v1/company/search",
    headers={"x-api-key": "<YOUR_API_KEY>"},
    params={"query": "Canva"}
)

results = response.json()["data"]
if results:
    company = results[0]
    print(f"UUID:    {company['uuid']}")
    print(f"Name:    {company['name']}")
    print(f"Website: {company['website']}")
    print(f"Status:  {company['company_status']}")

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
}

Field	Type	Description
`data`	object[]	Array of matching company objects. Empty array `[]` when no results are found.
`credits_consumed`	float	Always `0.00` — this is a free endpoint.

Company object

Field	Type	Description
`uuid`	string (UUID)	Unique Akta identifier for the company. Pass this as the `company` parameter in the Enrichment and News APIs.
`name`	string	Legal or registered company name.
`website`	string	Primary website URL, normalised with no trailing slash.
`product_category`	string	Primary product or service category (e.g. `"SaaS"`, `"FinTech"`, `"Healthcare"`).
`company_status`	string	Public 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.

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 Data API
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")

Getting Started

API Products

Resources

Developer Tools

Overview

Authentication

Request Reference

Response

Response envelope

Company object

Using the UUID in other APIs

​Overview

​Authentication

​Request Reference

​Response

​Response envelope

​Company object

​Using the UUID in other APIs

Overview

Authentication

Request Reference

Response

Response envelope

Company object

Using the UUID in other APIs