Audiences

List Audiences

Changed on

Lists an account's custom and lookalike audiences.

get/audiences

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/audiences
  • Auth: HTTP bearer

Query parameters

account_idstring required

Account ID, prefixed biz_.

audience_idstring

Audience ID, prefixed adaud_, used to filter the response to one audience.

audience_type'custom' | 'lookalike'

Filter by custom or lookalike audiences.

source_type'csv_upload' | 'people_filter' | 'engagement'

Filter by uploaded customer lists, Whop People filters, or social engagement.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

Response

Audiences listed.

Example response

{
  "data": [
    {
      "audience_type": "lookalike",
      "created_at": "2026-01-01T12:00:00.000Z",
      "engagement": {
        "exclude": [
          {
            "event": "watched_50_percent",
            "external_account_id": "sacc_xxxxxxxxxxxxxx",
            "object": "video",
            "platform_video_ids": [
              "444"
            ],
            "retention_days": 30
          }
        ],
        "include": [
          {
            "event": "watched_50_percent",
            "external_account_id": "sacc_xxxxxxxxxxxxxx",
            "object": "video",
            "platform_video_ids": [
              "444"
            ],
            "retention_days": 30
          }
        ],
        "platform": "meta"
      },
      "error_message": "412 of 1,000 rows had no email or phone number, so the list could not be matched.",
      "filters": {
        "country": "US",
        "last_seen_within_days": 30
      },
      "id": "adaud_xxxxxxxxxxxxxx",
      "last_refreshed_at": "2026-01-01T12:00:00.000Z",
      "lookalike_ratio": 0.04,
      "lookalike_starting_ratio": 0.02,
      "match_rates": [
        {
          "lower_bound": 40,
          "platform": "meta",
          "status": "available",
          "upper_bound": 50
        }
      ],
      "name": "Past purchasers Lookalike 2–4%",
      "platform_audience_ids": [
        "120246230799130687"
      ],
      "source_audience_id": "adaud_xxxxxxxxxxxxxx",
      "source_type": "csv_upload",
      "updated_at": "2026-01-01T12:00:00.000Z"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • 8d734102c0b6Revision changes
    • breaking

      removed the required property ///////////// from the response with the status

    • breaking

      removed the required property ///////////// from the response with the status

    • breaking

      removed the required property ///////////// from the response with the status

    • breaking

      removed the required property ///////////// from the response with the status

    • breaking

      removed the required property ///////////// from the response with the status

    • breaking

      removed the required property ///////////// from the response with the status

    • breaking

      removed the required property ///////////// from the response with the status

    • breaking

      removed the required property ///////////// from the response with the status

    • info

      added the required property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status

  • ff3a76573563Revision changes
    • breaking

      for the query request parameter first, default value 20 was added

    • warning

      for the query request parameter first, the max was set to 100.00