Skip to main content
POST
cURL

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 20 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

Header Parameters

string
required
Your API key.

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 an Enterprise-only 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 (Enterprise only), mna_and_investment (Enterprise only)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: relevance (default), revenue_estimate, valuation_estimate, employee_range, total_funding, founded_year
string
Sort direction.Available values: asc, descDefault = desc
integer
Maximum number of companies to return.Default = 50Max value = 500

Note: on Pay-as-you-go plan, maximum 20 companies are allowed.
integer
Number of results to skip for pagination.Default = 0

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 500.
float
Number of credits consumed by this request.

Authorizations

x-api-key
string
header
required

API key obtained from your Akta account.

Body

application/json
query
string

Natural language search query (e.g. 'SaaS companies in the US with Series A funding'). Cannot be used with filters.

filters
object

Structured filter conditions. Use the Filter Builder API to generate valid filters. Cannot be used with query. See filter options at /api-reference/listgen-api.

sections
string[]

Data enrichment sections to include. 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 (Enterprise), mna_and_investment (Enterprise)

sort_by
enum<string>

Field to sort results by. Default: relevance

Available options:
relevance,
revenue_estimate,
valuation_estimate,
employee_range,
total_funding,
founded_year
sort_order
enum<string>

Sort direction. Default: desc

Available options:
asc,
desc
limit
integer

Maximum companies to return. Default: 50, Max: 500

offset
integer

Number of results to skip for pagination. Default: 0

Response

Successful response

data
object[]
count
integer

Number of companies returned.

total_count
integer

Total matching companies. Capped at 500.

credits_consumed
number<float>

Credits consumed. Returns 0 when no enrichment sections requested.