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

# Search platform audiences

> Returns relevant platform audiences filtered by search term, dataset codes, and optional audience exclusions.




## OpenAPI

````yaml post /v1/spark-api/audiences/search
openapi: 3.0.0
info:
  title: SPARK API
  description: Spark REST API.
  version: 1.0.0
servers:
  - url: https://api.globalwebindex.com
security: []
paths:
  /v1/spark-api/audiences/search:
    post:
      tags:
        - Audiences
      summary: Search platform audiences
      description: >
        Returns relevant platform audiences filtered by search term, dataset
        codes, and optional audience exclusions.
      operationId: searchAudiences
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSearchRequest'
        description: Audience search request payload.
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSearchResponse'
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unauthorized'
        '422':
          description: Unprocessable entity.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnprocessableEntity'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    AudienceSearchRequest:
      type: object
      description: Request payload for audience search.
      required:
        - search_term
      properties:
        search_term:
          type: string
          description: Required text filter for audience title and description.
          example: gen z
        dataset_codes:
          type: array
          description: Optional dataset codes used to scope results.
          items:
            type: string
          example:
            - ds-core
        exclude_audience_ids:
          type: array
          description: Optional audience UUIDs to exclude from results.
          items:
            type: string
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          example:
            - 82d06fe7-b933-42f7-bd83-2d47b065fdcd
        limit:
          type: integer
          description: >-
            Optional maximum number of audiences to return (1-100). Omit to use
            the service default 20.
          default: 20
          minimum: 1
          maximum: 100
          example: 8
    AudienceSearchResponse:
      type: object
      description: Response payload for audience search.
      required:
        - audiences
      properties:
        audiences:
          type: array
          description: Matching audiences.
          items:
            $ref: '#/components/schemas/PlatformAudience'
      example:
        audiences:
          - id: b9272035-d1f0-4d56-a6bb-074847702c42
            title: 'OADB: Gen Z Who Aren''t Students'
            description: This audience consists of individuals who are part of Gen Z.
            type: curated
            datasets:
              - ds-core
    BadRequest:
      type: object
      description: Response payload for bad request.
      properties:
        code:
          type: integer
          description: The HTTP status code.
        message:
          type: string
          description: The reason for the error.
      example:
        code: 400
        message: Bad request reason
    Unauthorized:
      type: object
      description: Response payload for unauthorized.
      properties:
        message:
          type: string
      example:
        message: Unauthorized
    UnprocessableEntity:
      type: object
      description: Response payload unprocessable entity.
      properties:
        code:
          type: integer
          description: The HTTP status code.
        message:
          type: string
          description: The reason for the error.
      example:
        code: 422
        message: Unprocessable entity reason
    InternalServerError:
      type: object
      description: Response payload for internal server error.
      properties:
        code:
          type: integer
          description: The HTTP status code.
        message:
          type: string
          description: Generic error reason.
      example:
        code: 500
        message: There was an error processing your request. Please try again later.
    PlatformAudience:
      type: object
      description: A platform audience item.
      required:
        - id
        - title
        - description
        - type
        - datasets
      properties:
        id:
          type: string
          description: Audience UUID.
          example: 82d06fe7-b933-42f7-bd83-2d47b065fdcd
        title:
          type: string
          description: Audience title.
        description:
          type: string
          description: Audience description.
        type:
          type: string
          description: >-
            Audience provenance type (for example shared, curated, authored,
            instant).
        datasets:
          type: array
          description: Dataset codes associated with the audience.
          items:
            type: string
          example:
            - ds-core
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: Authorization
      type: apiKey

````