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 theuuid 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
query 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 thex-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. "00000l1"). The API automatically identifies the input type and resolves it. |
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": "00000l1",
"name": "Canva",
"website": "canva.com",
"product_category": "Visual Design Software",
"company_status": "Private"
},
{
"uuid": "0000ee3",
"name": "Canvas",
"website": "canvasapp.com",
"product_category": "Business Intelligence Software",
"company_status": "Private"
},
{
"uuid": "0000f2d",
"name": "Canvas",
"website": "canvas.build",
"product_category": "Construction Robotics",
"company_status": "Private"
},
{
"uuid": "0000x73",
"name": "Canvas",
"website": "canvas.io",
"product_category": "Spatial Intelligence and Reality Capture Software",
"company_status": "Private"
},
{
"uuid": "0004l71",
"name": "Canvas",
"website": "gocanvas.io",
"product_category": "Recruiting Software",
"company_status": "Private"
},
{
"uuid": "0004rkg",
"name": "Canvas",
"website": "bycanvas.org",
"product_category": "Arts and Cultural Philanthropy / Nonprofit Grantmaking",
"company_status": "Private"
},
{
"uuid": "0006abd",
"name": "Canvas",
"website": "canvas-inc.com",
"product_category": "Defense Engineering Services",
"company_status": "Private"
},
{
"uuid": "0009xss",
"name": "Canvas",
"website": "canvasunited.com",
"product_category": "Digital Marketing Services",
"company_status": "Private"
},
{
"uuid": "000adw7",
"name": "Canvas",
"website": "drivecanvas.com",
"product_category": "Vehicle Subscription Services",
"company_status": null
},
{
"uuid": "000d9vu",
"name": "Canvas",
"website": "canvas-events.co.uk",
"product_category": "Event Venue Marketplace",
"company_status": "Private"
},
{
"uuid": "000gz8w",
"name": "Canvas",
"website": "canvasuae.com",
"product_category": "Real Estate Brokerage",
"company_status": "Private"
},
{
"uuid": "000ltt3",
"name": "Canvas",
"website": "canvas-research.com",
"product_category": "Insufficient data",
"company_status": "Private"
},
{
"uuid": "000m2w5",
"name": "Canvas",
"website": "canvaslaapts.com",
"product_category": "Residential Apartment Rentals (Multifamily Housing)",
"company_status": "Private"
},
{
"uuid": "000ps2l",
"name": "Canvas",
"website": "canvasrealestate.com",
"product_category": "Commercial Real Estate Brokerage",
"company_status": "Private"
},
{
"uuid": "000zly3",
"name": "Canvas",
"website": "canvascos.com",
"product_category": "Real Estate Development",
"company_status": "Private"
},
{
"uuid": "00269km",
"name": "Canvas",
"website": "canvas.krd",
"product_category": "Digital Marketing Services",
"company_status": "Private"
},
{
"uuid": "002romp",
"name": "Canvas",
"website": "canevas.be",
"product_category": "Architecture and Engineering Services",
"company_status": "Private"
},
{
"uuid": "002w1kw",
"name": "Canvas",
"website": "canvs.co.jp",
"product_category": "Startup Studio / Venture Incubation Services",
"company_status": "Private"
},
{
"uuid": "003764u",
"name": "Canvas",
"website": "leinwand-praesentationssoftware.de",
"product_category": "Presentation and Drawing Software",
"company_status": "Private"
},
{
"uuid": "0042w4m",
"name": "Canvas",
"website": "canvasliving.com.au",
"product_category": "Build to Rent Property Management",
"company_status": "Private"
},
{
"uuid": "0064st1",
"name": "canvay",
"website": "canvay.io",
"product_category": "Web Hosting Services",
"company_status": "Private"
},
{
"uuid": "00stcqh",
"name": "Canvas",
"website": "canvas-inc.co",
"product_category": "Marketing Automation SaaS",
"company_status": "Private"
},
{
"uuid": "0008n11",
"name": "Canvas8",
"website": "canvas8.com",
"product_category": "Consumer Insights & Market Research",
"company_status": "Private"
},
{
"uuid": "000c98x",
"name": "Canvazo",
"website": "canvazo.com",
"product_category": "Art Supplies E-commerce",
"company_status": "Private"
},
{
"uuid": "002l5yx",
"name": "Canvass",
"website": "canvass-srl.it",
"product_category": "Industrial Cleaning Equipment & Supplies",
"company_status": "Private"
}
],
"count": 25,
"credits_consumed": 0
}
| 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.pro 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". |
data array.
Using the UUID in other APIs
Once you have theuuid, 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.get(
"https://api.akta.pro/api/v1/company/enrichment/", # was POST /v1/company/enrichment
headers=HEADERS,
params={"company": uuid, "sections": "firmographic,business_model"}
)
enrich.raise_for_status()
enrich_data = enrich.json()
print(enrich_data["data"]["firmographic"]["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}
)
news.raise_for_status()
news_data = news.json()
article_count = news_data.get("count", news_data.get("total", "unknown"))
print(f"Found {article_count} articles")
.png?fit=max&auto=format&n=tMpg-r-6yeOIk-hz&q=85&s=e0cafcb914826d8adc60e5092187e1ca)
.png?fit=max&auto=format&n=tMpg-r-6yeOIk-hz&q=85&s=f214ebe0a940d8aa0f19a709a6bfd7fa)