Company Data API Best Practices

Always specify sections Request only the sections you need. Each sections consumes credits. Refer to pricing page for more details. Accept both domain and full URL formats The company parameter accepts both bare domains (canva.com) and full URLs (https://www.canva.com). Either format works so use whichever is more natural for your pipeline. If you have a UUID from Company Search, prefer that for the most reliable resolution:

# All three are valid
params={"company": "canva.com"}
params={"company": "https://www.canva.com"}
params={"company": "00000l1"}

Use Company Search to resolve names to UUIDs before enriching If your input is a company name (not a domain), resolve it to a UUID via the Company Search API first. Passing a display name like "Canva" directly as the company parameter may not resolve. Use the domain or UUID returned by Company Search:

import requests

API_KEY = "YOUR API KEY"
HEADERS = {"x-api-key": API_KEY}

def get_company_uuid(company_name):
    search = requests.get(
        "https://api.akta.pro/api/v1/company/search",
        headers=HEADERS,
        params={"query": company_name}
    )
    search.raise_for_status()

    results = search.json().get("data", [])
    if not results:
        raise ValueError(f"Company not found: {company_name}")

    return results[0]["uuid"]

if __name__ == "__main__":
    company_uuid = get_company_uuid("Canva")
    print(f"UUID: {company_uuid}")

Sections for Enterprise tier - funding_detailand mna_and_investment require enterprise tier The funding_detail and mna_and_investment sections are gated to enterprise plans. If your plan does not include them, requesting them returns a 403 error. Handle this in your section selection logic rather than letting it surface as an uncaught error.

Getting Started

API Products

Resources

Developer Tools