Skip to main content
POST
List Generation API

Overview

The List Generation API lets you build targeted company lists using two approaches:
  1. Structured Filters - Applies specific criteria like company type, location, funding stage, or industry to filter companies
  2. Natural Language - Describe what you’re looking for in plain text and the API interprets your intent
Results are ranked by akta.pro relevance by default and can be enriched with additional company data sections.
The List Generation API is fully available on Subscription and Enterprise plans. On the Pay-as-you-go plan, list generation is limited to a maximum of 50 companies per request, and enrichment is not supported. See Pricing for plan details.

Endpoint Details

  • Method: POST
  • Endpoint: /api/v1/list/generate/companies/

Authentication requirements

  • Include a valid API key in the x-api-key request header.

Request

Request Parameters

Body Parameters

string
Natural language search query. Use this when you want to describe your target companies in plain text (e.g., “SaaS companies in the US with Series A funding”).Note: Cannot be used together with filters. Choose either query or filters, not both.
object
Structured filter conditions. Use this when you need precise control over filtering criteria.Note: Cannot be used together with query.

Available Filters

Filters from different groups can be combined in a single request. All conditions are combined with AND logic. A company must match every specified filter to be included in the results. The example below combines a firmographic filter, a location filter, a financial estimate range filter, a technology boolean filter, a business model filter, and a Subscription/Enterprise funding detail nested filter:
string[]
Additional data sections to include for each company in the results.Available values: firmographic, business_model, company_assessment, trust_signal, company_hierarchy, digital_presence, financial_estimate, location, management_profile, product_offering, strategic_signal, customer_profile, industry, technology, funding_detail (Subscription, Enterprise), mna_and_investment (Subscription, Enterprise)If omitted, results include only basic identity fields (uuid, name, website).

Note: These sections are not supported on Pay-as-you-go plan.
string
Field to sort results by.Available values: revenue_estimate, valuation_estimate, employee_range, total_funding, founded_year , headcount, relevance
string
Sort direction.Available values: asc, descDefault = desc
integer
Maximum number of companies to return.Default = 50Max value = 100

Note: on Pay-as-you-go plan, maximum 50 companies are allowed.
integer
Number of results to skip for pagination.Default = 0Note: For Starter, Build, Growth plans limit+offset ≤ 1000. For Pay-as-you-go plan, limit+offset ≤50

Response

Successful Response Fields

array
List of matching company objects. Each object includes identity fields (uuid, name, website) plus any requested enrichment sections.
integer
Number of companies returned in this response.
integer
Total number of companies matching your filters. Capped at 1000.
float
Number of credits consumed by this request.