Arikaart ai data agent documentation

# Search companies by name
import requests

# Search with optional filters, page 2
response = requests.get("http://localhost:5000/api/search",
    params={"category": "software", "location": "tartu", "employee_limit": 25, "residency": "non_estonian", "limit": 5, "page": 2}
)
data = response.json()
print(data["results"][0])

# Request exact totals only when needed
response = requests.get("http://localhost:5000/api/search",
    params={"q": "tech", "limit": 5, "include_total": True}
)
data_with_total = response.json()
print(f"Found {data_with_total['total']} companies")

# Search companies by category
response = requests.get("http://localhost:5000/api/category-search",
    params={"category": "Programmeerimine", "limit": 5, "page": 1}
)
category_data = response.json()
print(f"Found {category_data['total']} category matches")

# Lithuania legal entities search
response = requests.get("http://localhost:5000/api/lithuania/search",
    params={"q": "uab", "limit": 5}
)
lt_data = response.json()
print(f"Found {lt_data['total']} LT entities")

# Lithuania company by registration code
response = requests.get("http://localhost:5000/api/lithuania/company/110005648")
lt_company = response.json()
print(lt_company)

# Lithuania balance sheet by company code
response = requests.get("http://localhost:5000/api/lithuania/balance-sheet",
    params={"ja_kodas": "110005648", "limit": 5}
)
bs_data = response.json()
print(f"Found {bs_data['total']} balance sheet rows")

# Lithuania profit and loss by company code
response = requests.get("http://localhost:5000/api/lithuania/profit-loss",
    params={"ja_kodas": "110005648", "limit": 5}
)
pl_data = response.json()
print(f"Found {pl_data['total']} profit & loss rows")

# Lithuania NGO by company code
response = requests.get("http://localhost:5000/api/lithuania/ngos",
    params={"ja_kodas": "303530932"}
)
ngo_data = response.json()
print(ngo_data)

# Get company by registration code
response = requests.get("http://localhost:5000/api/company/12345678")
company = response.json()
print(f"Company: {company['name']}")

# Get company leaders by registration code
response = requests.get("http://localhost:5000/api/leaders/12345678")
leaders = response.json()
print(leaders)

# Get company shareholders by registration code
response = requests.get("http://localhost:5000/api/shareholders/16752073")
shareholders = response.json()
print(shareholders)

# List companies with non-Estonian shareholders
response = requests.get("http://localhost:5000/api/global-filters",
    params={"residency": "non_estonian", "category": "software", "location": "tartu", "employee_limit": 25, "limit": 5, "page": 1}
)
shareholder_companies = response.json()
print(f"Found {shareholder_companies['total']} companies")

# Search Latvia companies with schema-backed filters
response = requests.get("http://localhost:5000/api/latvia/search",
    params={"q": "tech", "status": "active", "registered_from": "2020-01-01", "limit": 5}
)
latvia_data = response.json()
print(f"Found {latvia_data['total']} Latvia companies")

# Get top domain for company name
response = requests.get("http://localhost:5000/api/domains",
    params={"q": "kontorva"}
)
domain_result = response.json()
print(domain_result)

// Search companies using fetch API
async function searchCompanies(query, filters = {}) {
    const params = new URLSearchParams({
        limit: filters.limit ?? 20,
        page: filters.page ?? 1
    });
    if (query) params.set("q", query);
    if (filters.category) params.set("category", filters.category);
    if (filters.location) params.set("location", filters.location);
    if (filters.employee_limit !== undefined) params.set("employee_limit", filters.employee_limit);
    if (filters.residency) params.set("residency", filters.residency);
    if (filters.include_total) params.set("include_total", "true");
    const response = await fetch(`/api/search?${params.toString()}`);
    const data = await response.json();
    return data;
}

// Search companies by category
async function searchByCategory(category, limit = 20, page = 1) {
    const response = await fetch(
        `/api/category-search?category=${encodeURIComponent(category)}&limit=${limit}&page=${page}`
    );
    return await response.json();
}

// Get company by code
async function getCompany(code) {
    const response = await fetch(`/api/company/${code}`);
    return await response.json();
}

// Get company leaders by code
async function getLeaders(code) {
    const response = await fetch(`/api/leaders/${code}`);
    return await response.json();
}

// Get company shareholders by code
async function getShareholders(code) {
    const response = await fetch(`/api/shareholders/${code}`);
    return await response.json();
}

// List companies by shareholder residency classification
async function listShareholderCompanies(residency = "all", limit = 20, page = 1) {
    const params = new URLSearchParams({
        residency: residency,
        limit: limit,
        page: page
    });
    const response = await fetch(`/api/global-filters?${params.toString()}`);
    return await response.json();
}

// Get top domain for a company name
async function getCompanyDomain(name) {
    const response = await fetch(
        `/api/domains?q=${encodeURIComponent(name)}`
    );
    return await response.json();
}

# Search for companies
curl "http://localhost:5000/api/search?category=software&location=tartu&employee_limit=25&residency=non_estonian&limit=5&page=2"

# Search with exact total count
curl "http://localhost:5000/api/search?q=tech&limit=5&include_total=true"

# Search companies by category
curl "http://localhost:5000/api/category-search?category=Programmeerimine&limit=5&page=1"

# Search Lithuania legal entities by name
curl "http://localhost:5000/api/lithuania/search?q=uab&limit=5"

# Lithuania company by registration code
curl "http://localhost:5000/api/lithuania/company/110005648"

# Lithuania balance sheet by company code
curl "http://localhost:5000/api/lithuania/balance-sheet?ja_kodas=110005648&limit=5"

# Lithuania profit and loss by company code
curl "http://localhost:5000/api/lithuania/profit-loss?ja_kodas=110005648&limit=5"

# Lithuania NGO by company code
curl "http://localhost:5000/api/lithuania/ngos?ja_kodas=303530932"

# Search procurement notices by company name
curl "http://localhost:5000/api/procurement?q=hiiumaa&limit=5&page=1"

# Get company by registration code
curl "http://localhost:5000/api/company/12345678"

# Get company leaders by registration code
curl "http://localhost:5000/api/leaders/12345678"

# Get company shareholders by registration code
curl "http://localhost:5000/api/shareholders/16752073"

# List companies with non-Estonian shareholders
curl "http://localhost:5000/api/global-filters?residency=non_estonian&category=software&location=tartu&employee_limit=25&limit=5&page=1"

# Search Latvia companies with supported filters
curl "http://localhost:5000/api/latvia/search?q=tech&status=active®istered_from=2020-01-01&limit=5"

# Get top domain for company name
curl "http://localhost:5000/api/domains?q=kontorva"

# Get API health status
curl "http://localhost:5000/api/health"

# Get all table row counts
curl "http://localhost:5000/api/table-stats"

# Bulk search with POST
curl -X POST http://localhost:5000/api/bulk-search   -H "Content-Type: application/json"   -d '{"codes": ["12345678", "87654321"]}'