ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

audiences

List audiences

Changed on Jun 4, 2026

Get list of audiences for the ad account.

get/ad_accounts/{ad_account_id}/audiences

Request

Base URL
https://api.pinterest.com/v5
Auth
- OAuth 2
  Authorization codehttps://www.pinterest.com/oauth/
  Token URLhttps://api.pinterest.com/v5/oauth/token
  Scopesads:read
- or OAuth 2
  Client credentials
  Token URLhttps://api.pinterest.com/v3/oauth/access_token/
  Scopesads:read
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/audiences/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Query parameters

bookmarkstring

Cursor used to fetch the next page of items

page_sizeinteger

Maximum number of items to include in a single page. See documentation on Pagination for more information.

order'ASCENDING' | 'DESCENDING'

The order in which to sort the items returned: "ASCENDING" or "DESCENDING" by ID. Note that higher-value IDs are associated with more-recently added items.

ownership_type'OWNED' | 'RECEIVED'

Filter audiences by ownership type.

exclude_ncaboolean

When true, excludes audiences derived from new customer acquisition (expanded matching) customer lists from the result. Defaults to false (include all).

Response

The request has succeeded.

bookmarkstring nullable

Example response

{
  "items": [
    {
      "audience_type": "ACTALIKE",
      "rule": {
        "event_data": {
          "lead_type": "Newsletter",
          "line_items": {
            "product_brand": "Parker",
            "product_category": "Shoes",
            "product_id": 1414,
            "product_name": "Parker Boots",
            "product_price": "99.99",
            "product_quantity": 2,
            "product_variant": "Red",
            "product_variant_id": "1414-34832"
          },
          "order_id": "X-151481",
          "order_quantity": 1,
          "page_name": "Our Favorite Pins on Pinterest",
          "promo_code": "WINTER10",
          "property": "Athleta",
          "search_query": "boots",
          "value": "199.98",
          "video_title": "How to style your Parker Boots"
        }
      }
    }
  ]
}

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  for the query request parameter order, default value ASCENDING was added
- breaking
  the response's body type changed from no type to object for status
- info
  added the new optional query request parameter exclude_nca
- info
  removed subschema #2 from the response body allOf list for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
Dec 11, 2025v579f62f71f05b Revision changes
- breaking
  the ///// response's property type changed from string to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- info
  added to the ///// response property allOf list for the response status
- info
  added to the ///// response property allOf list for the response status
- info
  removed the ARS enum value from the ///// response property for the response status
- info
  removed the AUD enum value from the ///// response property for the response status
- info
  removed the BRL enum value from the ///// response property for the response status
- info
  removed the CAD enum value from the ///// response property for the response status
- info
  removed the CHF enum value from the ///// response property for the response status
- info
  removed the CLP enum value from the ///// response property for the response status
- info
  removed the COP enum value from the ///// response property for the response status
- info
  removed the CZK enum value from the ///// response property for the response status
- info
  removed the DKK enum value from the ///// response property for the response status
- info
  removed the EUR enum value from the ///// response property for the response status
- info
  removed the GBP enum value from the ///// response property for the response status
- info
  removed the HKD enum value from the ///// response property for the response status
- info
  removed the HUF enum value from the ///// response property for the response status
- info
  removed the ILS enum value from the ///// response property for the response status
- info
  removed the INR enum value from the ///// response property for the response status
- info
  removed the JPY enum value from the ///// response property for the response status
- info
  removed the KRW enum value from the ///// response property for the response status
- info
  removed the MXN enum value from the ///// response property for the response status
- info
  removed the NOK enum value from the ///// response property for the response status
- info
  removed the NZD enum value from the ///// response property for the response status
- info
  removed the PLN enum value from the ///// response property for the response status
- info
  removed the RON enum value from the ///// response property for the response status
- info
  removed the SEK enum value from the ///// response property for the response status
- info
  removed the SGD enum value from the ///// response property for the response status
- info
  removed the TRY enum value from the ///// response property for the response status
- info
  removed the UNK enum value from the ///// response property for the response status
- info
  removed the USD enum value from the ///// response property for the response status

Operation history (10 revisions)