List product groups

GET {{baseUrl}}/catalogs/product_groups?feed_id=24989&catalog_id=24989&bookmark=<string>&page_size=25&ad_account_id=15266090296

Get a list of product groups for a given Catalogs Feed Id owned by the operation user_account. - By default, the operation user_account is the token user_account.

Optional: Business Access: Specify an adaccountid (obtained via List ad accounts) to use the owner of that adaccount as the "operation useraccount. In order to do this, the token user_account must have one of the following https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access roles on the ad_account: Owner, Admin, Catalogs Manager.

Learn more

Request Params

KeyDatatypeRequiredDescription
feed_idnumberFilter entities for a given feed_id. If not given, all feeds are considered.
catalog_idnumberFilter entities for a given catalog_id. If not given, all catalogs are considered.
bookmarkstringCursor used to fetch the next page of items
page_sizenumberMaximum number of items to include in a single page of the response. See documentation on <a href='/docs/getting-started/pagination/'>Pagination</a> for more information.
ad_account_idnumberUnique identifier of an ad account.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;items&quot;:[{&quot;filters&quot;:{&quot;any_of&quot;:[{&quot;MIN_PRICE&quot;:{&quot;values&quot;:&quot;\u003cnumber\u003e&quot;,&quot;inclusion&quot;:true,&quot;negated&quot;:false}},{&quot;MIN_PRICE&quot;:{&quot;values&quot;:&quot;\u003cnumber\u003e&quot;,&quot;inclusion&quot;:true,&quot;negated&quot;:false}}]},&quot;id&quot;:&quot;4174&quot;,&quot;feed_id&quot;:&quot;7&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_featured&quot;:&quot;\u003cboolean\u003e&quot;,&quot;type&quot;:&quot;PINNER_FAVORITES&quot;,&quot;status&quot;:&quot;ACTIVE&quot;,&quot;created_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;catalog_type&quot;:&quot;RETAIL&quot;},{&quot;filters&quot;:{&quot;any_of&quot;:[{&quot;MIN_PRICE&quot;:{&quot;values&quot;:&quot;\u003cnumber\u003e&quot;,&quot;inclusion&quot;:true,&quot;negated&quot;:false}},{&quot;MIN_PRICE&quot;:{&quot;values&quot;:&quot;\u003cnumber\u003e&quot;,&quot;inclusion&quot;:true,&quot;negated&quot;:false}}]},&quot;id&quot;:&quot;16084589&quot;,&quot;feed_id&quot;:&quot;66814&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_featured&quot;:&quot;\u003cboolean\u003e&quot;,&quot;type&quot;:&quot;MERCHANT_CREATED&quot;,&quot;status&quot;:&quot;INACTIVE&quot;,&quot;created_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;catalog_type&quot;:&quot;RETAIL&quot;}],&quot;bookmark&quot;:&quot;\u003cstring\u003e&quot;}