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

# List audience members API

> Page through an audience's member domains in alphabetical order, with the total and build timestamp. Works for every audience kind. Free.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Is this endpoint free?">
    Yes. Reading membership costs nothing — it is a cheap indexed lookup. Only the analytical endpoints (technology report, breakdown, segment stats) cost a credit.
  </Accordion>

  <Accordion title="How do I export the whole membership?">
    Page with `limit` (max 100) and `offset`. For anything large, export the audience as a [lead list](/docs/api-reference/lead-lists/create-lead-list-api) instead by passing `segment_id` to the create endpoint — that gives you a downloadable file with company and contact data attached.
  </Accordion>

  <Accordion title="Why is total different from what I uploaded?">
    Uploaded domains are normalized and deduped before storage, so a list with duplicates or `www.` prefixes will come back smaller. Check `rejected_domains` in the create response for entries that failed validation entirely.
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml GET /v1/segments/{id}/domains
openapi: 3.1.0
info:
  title: TechnologyChecker API
  description: >-
    Discover technology stacks, track market trends, and enrich data with
    company intelligence.
  version: 1.0.0
  contact:
    name: TechnologyChecker Support
    email: support@technologychecker.io
    url: https://technologychecker.io
servers:
  - url: https://api.technologychecker.io
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Domain technologies
    description: Look up technologies detected on any domain
  - name: Technology data
    description: Search, look up, and get details on tracked technologies
  - name: Market intelligence
    description: Technology stats, trends, and market share
  - name: Company data
    description: Firmographic and company intelligence
  - name: Live detection
    description: Real-time technology detection with browser rendering
  - name: Signals
    description: >-
      Intent signals derived from technology state transitions: who adopted, who
      churned, who switched, and who has a gap in their stack.
  - name: Alerts
    description: >-
      Saved signal queries delivered to your webhook. Every signal you can
      query, you can subscribe to.
  - name: Audiences
    description: >-
      Saved groups of domains — uploaded lists or computed recipes — that you
      can profile, slice and monitor.
  - name: Lead lists
    description: >-
      Build and export targeted domain lists combining technology detection with
      company data.
paths:
  /v1/segments/{id}/domains:
    get:
      tags:
        - Audiences
      summary: List audience members API
      description: >-
        A page of the audience's member domains in the current generation,
        ordered alphabetically, plus the total and the build timestamp. Works
        for every audience kind. Free.
      operationId: listAudienceMembers
      parameters:
        - name: id
          in: path
          required: true
          description: The audience id.
          schema:
            type: string
            example: seg_8f3a2c1b
        - name: limit
          in: query
          required: false
          description: Domains per page. Clamped to 1–100.
          schema:
            type: integer
            default: 50
            minimum: 1
            maximum: 100
        - name: offset
          in: query
          required: false
          description: Pagination offset.
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: A page of member domains
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      segment:
                        type: object
                        properties:
                          id:
                            type: string
                            example: seg_8f3a2c1b
                          name:
                            type: string
                            example: YC W25 portfolio
                          type:
                            type: string
                            example: list
                          kind:
                            type: string
                            example: upload
                          status:
                            type: string
                            example: ready
                          membership_at:
                            type: string
                            nullable: true
                      domains:
                        type: array
                        items:
                          type: object
                          properties:
                            domain:
                              type: string
                              example: acme.com
                      total:
                        type: integer
                        example: 5914
                      limit:
                        type: integer
                        example: 50
                      offset:
                        type: integer
                        example: 0
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          $ref: '#/components/responses/QueryTimeout'
components:
  responses:
    BadRequest:
      description: Invalid or missing parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            success: false
            error:
              code: VALIDATION_ERROR
              message: >-
                Provide exactly one scope: technology_id, technology or
                category_id.
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    QueryTimeout:
      description: >-
        The query exceeded the 30-second server-side limit. Narrow the query and
        retry.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            success: false
            error:
              code: SEGMENT_QUERY_TIMEOUT
              message: The segment query exceeded the 30s server-side limit.
              details:
                suggestion: >-
                  Narrow the segment — add an employees band, industry, or city
                  — and try again.
  schemas:
    ApiError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: string
              example: UNAUTHORIZED
            message:
              type: string
              example: Missing or invalid API key
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key in format `tapi_live_[32-char]` (live) or `tapi_test_[32-char]`
        (test)

````