List Generation

Build targeted company lists using structured filters or natural language queries, with optional data enrichment.

post/v1/list/generate/companies/

Request

  • Base URL: https://api.akta.pro/api
  • URL: https://api.akta.pro/api/v1/list/generate/companies/
  • Auth: API key in header x-api-key

Request body

querystring

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

filtersobject

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.

sectionsstring[]

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 (Subscription, Enterprise), mna_and_investment (Subscription, Enterprise)

sort_by'relevance' | 'revenue_estimate' | 'valuation_estimate' | 'employee_range' | 'total_funding' | 'founded_year'

Field to sort results by. Default: relevance

sort_order'asc' | 'desc'

Sort direction. Default: desc

limitinteger

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

offsetinteger

Number of results to skip for pagination. Default: 0

Response

Successful response

dataobject[]
countinteger

Number of companies returned.

total_countinteger

Total matching companies. Capped at 500.

credits_consumednumber float

Credits consumed. Returns 0 when no enrichment sections requested.

Changes

No recorded changes to this operation across all 1 revision of this API.