akta.pro

Report the current user's account details and credit balance. Free. No arguments — identity is taken from the authenticated API key. Call this when the user asks about their plan, credits, or limits, and consult it before attempting tools pay-as-you-go can't use (headcount_trends, website_traffic, employee_reviews, product_reviews, job_posts, social_posts) or the Funding Detail / M&A and Investment enrichment sections (not on pay-as-you-go) to pre-empt a 403. The tier also sets the news_signals lookback limit (pay-as-you-go 6 months, subscription 1 year, agent and enterprise unlimited) and the generate_company_list window (pay-as-you-go 20, every other plan 500). Returns: is_enterprise (bool — true only on enterprise, not agent; do not use it to decide funding/M&A access, which subscription and agent have too), package_type (top_up = pay-as-you-go | subscription | agent | enterprise), credit_balance (remaining credits), currency.

account_status

Enrich a company with the requested sections, returned as Markdown. akta-pro renders the (large, deeply-nested) company data into clean Markdown server-side. Sections (credits): firmographic 2, business_model 2, company_assessment 2, trust_signal 0.5, company_hierarchy 0.5, digital_presence 0.5, financial_estimate 0.5, location 0.5, management_profile 1, product_offering 2, strategic_signal 1.5, customer_profile 1, industry 0.5, technology 2, funding_detail 3, mna_and_investment 5. funding_detail and mna_and_investment are included on Subscription, Agent and Enterprise plans. Subscription and Agent get a trimmed view (first 3 rounds/investors/deals, month-year dates, with a note listing what is withheld); Enterprise gets the full data. On pay-as-you-go they are skipped (not an error); the returned Markdown notes any that were dropped. funding_detail and mna_and_investment are included on Subscription, Agent and Enterprise plans. Subscription and Agent get a trimmed view (first 3 rounds/investors/deals, month-year dates, with a note listing what is withheld); Enterprise gets the full data. On pay-as-you-go they are skipped (not an error); the returned Markdown notes any that were dropped. Prerequisite: `company` must be an akta-pro uuid from company_search (free). Names and websites are rejected. API: GET /company/enrichment/markdown — the Markdown variant of akta-pro's Company Data API, documented at https://docs.akta.pro/api-reference/company-data; the fields each section carries are listed at https://docs.akta.pro/company-data-dictionary.

company_data

Resolve a company by name or website to its akta-pro identifiers. ALWAYS call this first. Every other company tool accepts ONLY the `uuid` returned here — names and websites are rejected — so this is also the only way to check whether a company exists in akta-pro at all. Free (0 credits). Returns candidates with uuid, name, website, product_category, and public/private status. A child company also carries `parent_company` ({name, uuid}) pointing at its parent. By default only top-level companies are returned; pass include_child_companies=True to also match subsidiaries and divisions. Searching by a child company's own uuid finds it either way. Results are ranked but not disambiguated: one website can map to several distinct entities (stripe.com → Stripe, Stripe Capital, Stripe Atlas). Pick the candidate that matches the user's intent, and if none does, say the company isn't covered rather than passing a guessed uuid.

company_search

Return a condensed company overview (no section selection). akta-pro returns a slimmed JSON with the fluff redacted — much smaller than full enrichment. Flat cost 3 credits. This tool never returns funding or M&A data. Use company_data with funding_detail / mna_and_investment (Subscription, Agent and Enterprise plans) to get them. Prerequisite: `company` must be an akta-pro uuid from company_search (free). Names and websites are rejected. API: GET /company/enrichment/concise (akta-pro Company Data API — https://docs.akta.pro/api-reference/company-data).

company_data_concise

Employee reviews: overall + dimension-level ratings and individual reviews (Glassdoor et al.). 1.5 credits per 50 reviews. Prerequisite: `company` must be an akta-pro uuid from company_search (free). Names and websites are rejected.

employee_reviews

Run a company list: the companies matching your filters. Cost: 1.5 credits per call that returns companies + 0.2 per company, so 20 companies is 5.5 credits. A query matching nothing is FREE. The cost does not depend on the fields: this tool always returns the same identifying fields per company and never full enrichment, so screening a list is cheap and predictable. For depth, call company_data on the few uuids that matter — that is billed per section, on those companies only. Prerequisites, in order: list_filters() to see what exists, then get_filter_values() for every filter that has a `dropdown_type`. Use those values VERBATIM and never write one from memory — these are exact strings from akta-pro's data, so an invented value matches zero companies instead of erroring. Key this call by each entry's `filter` — the one name that field has everywhere. Send at least one selective filter. A very broad or unfiltered query is rejected, not slow — it exhausts the backend's query timeout. Always read `warnings` in the result. A value that was dropped there means the list is BROADER than what the user asked for, which otherwise looks exactly like a good answer; a `coerced` entry means a value was normalised to its canonical form (harmless, but worth trusting over your own spelling next time). A filter key that isn't in list_filters() is an error, not a warning — the call fails with the offending key named and costs nothing, so fix the key and retry rather than guessing. Each company comes back with uuid, name, website, product_category, company_type and hq_country — that is the whole row; there is no option to return more per company. Feed a `uuid` straight into company_data / news_signals for depth on one of them. `total_count` saturates at 500, meaning "500 or more" — it is also the deepest page reachable, so narrow the filters rather than paging past it. API: POST /list/generate/companies/ — akta-pro's List Generation API, documented at https://docs.akta.pro/api-reference/listgen-api (filter keys, value shapes, sort fields, response envelope).

generate_company_list

Get the allowed values for one or more filters. Free (0 credits). Two kinds of result: * A fixed list -> [{label, value}]. Use `value` verbatim; `label` is just the human-readable form. `query` substring-filters the list. * A searched taxonomy (industry.industry, industry.naics, industry.sic; investors resolve to companies) -> ranked matches with a `code` and a similarity score. `query` is REQUIRED, and you use the `code`. For `industry`, `level` picks how deep in the taxonomy to search — leave it at the ['l4'] default for a specific niche, and pass ['all'] for a broad sector, since a broader code matches every company beneath it in the hierarchy. NEVER write a value from memory. These are exact strings from akta-pro's data, and a value that merely looks plausible matches zero companies instead of failing — so a made-up value silently ruins the whole query. If nothing returned clearly means what the user asked for, leave that filter out rather than forcing a weak match. Check `truncated` / `total_available`: if what you need isn't in the list, re-query with a narrower `query`. API: POST /filters/options/ (akta-pro) — the value lookups behind the filters documented at https://docs.akta.pro/api-reference/listgen-api.

get_filter_values

LinkedIn-sourced headcount: total employees, historical growth, and breakdown by function. 2.5 credits. Prerequisite: `company` must be an akta-pro uuid from company_search (free). Names and websites are rejected.

headcount_trends

Resolve a free-text industry to akta-pro industry codes. Free (0 credits). Returns code, industry_name, and similarity score. The codes serve two purposes: * news_signals — pass them as the `industry` filter. * company lists — use them as `industry.industry` filter values in generate_company_list (the same lookup as get_filter_values with dropdown_type 'industry.industry'). A broader code matches every company beneath it in the hierarchy. `level` picks the taxonomy depth(s); several can be combined.

industry_search

Live LinkedIn/Indeed job posts: title, location, description, compensation, experience level, and key skills. 4 credits. Prerequisite: `company` must be an akta-pro uuid from company_search (free). Names and websites are rejected.

job_posts