Arikaart ai data agent documentation

# Search companies by name
import requests

# Search by name with filters, page 2
response = requests.get("http://localhost:5000/api/search",
    params={"q": "tech", "category": "software", "location": "tartu", "employee_limit": 25, "limit": 5, "page": 2}
)
data = response.json()
print(f"Found {data['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", "limit": 5, "page": 1}
)
shareholder_companies = response.json()
print(f"Found {shareholder_companies['total']} 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({
        q: query,
        limit: filters.limit ?? 20,
        page: filters.page ?? 1
    });
    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);
    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?q=tech&category=software&location=tartu&employee_limit=25&limit=5&page=2"

# 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&limit=5&page=1"

# 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"]}'