> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Generation

> Build targeted company lists from structured filters or a natural-language query, with optional per-section enrichment.



## OpenAPI

````yaml openapi/zh/akta.json POST /apis/v1/akta/list/generate/companies
openapi: 3.1.0
info:
  description: ''
  title: Akta
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/akta/company/addition-requests
    - /apis/v1/akta/company/enrichment
    - /apis/v1/akta/company/search
    - /apis/v1/akta/industry/search
    - /apis/v1/akta/list/filter-builder
    - /apis/v1/akta/list/generate/companies
    - /apis/v1/akta/status/{request_id}
  x-aisa-document:
    facts_hash: 7ad2bb35e79170f8bebe26bf1fa819a258abc8b522c89db48b3c83294f1e6e9f
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:297b13ae403b249c39c60ae0ccc66e53cc204c8141090816e0835b4e990f3be7
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: akta
  x-aisa-catalogs:
    akta:
      title: Akta
      description: ''
      x-aisa-document:
        facts_hash: 7ad2bb35e79170f8bebe26bf1fa819a258abc8b522c89db48b3c83294f1e6e9f
        generator_version: '2'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/akta/list/generate/companies:
    post:
      tags:
        - list-generation
      summary: List Generation
      description: >-
        Build targeted company lists from structured filters or a
        natural-language query, with optional per-section enrichment.
      operationId: post_akta_list_generate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: >-
                    Natural language search query (e.g. 'SaaS companies in the
                    US with Series A funding'). Cannot be used with filters.
                filters:
                  type: object
                  additionalProperties: true
                  description: >-
                    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:
                  type: array
                  items:
                    type: string
                  description: >-
                    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:
                  type: string
                  enum:
                    - relevance
                    - revenue_estimate
                    - valuation_estimate
                    - employee_range
                    - total_funding
                    - founded_year
                  description: 'Field to sort results by. Default: relevance'
                sort_order:
                  type: string
                  enum:
                    - asc
                    - desc
                  description: 'Sort direction. Default: desc'
                limit:
                  type: integer
                  description: 'Maximum companies to return. Default: 50, Max: 500'
                offset:
                  type: integer
                  description: 'Number of results to skip for pagination. Default: 0'
      responses:
        '200':
          description: 成功响应
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Response73D692Ab31Ca_ListGenerationResponse
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    Response73D692Ab31Ca_ListGenerationResponse:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            description: >-
              Company object with identity fields (uuid, name, website) plus any
              requested enrichment sections.
        count:
          type: integer
          description: Number of companies returned.
        total_count:
          type: integer
          description: Total matching companies. Capped at 500.
        credits_consumed:
          type: number
          format: float
          description: Credits consumed. Returns 0 when no enrichment sections requested.
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.