List catalogs

GET

/catalogs

Fetch catalogs owned by the "operation user_account".
  • By default, the "operation user_account" is the token user_account.
Optional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following Business Access roles on the ad_account: Owner, Admin, Catalogs Manager.
Learn more
Ratelimit category:
catalogs_read
Sandbox support:
enabled

Authorizations

Pinterest OAuth 2.0
Scopes:
catalogs:read

Query Parameters

Payload information
bookmark
string
Cursor used to fetch the next page of items
page_size
integer
[1 ... 250]
Default:
25
Maximum number of items to include in a single page of the response. See documentation on Pagination for more information.
ad_account_id
string
<= 18 characters
^\d+$
Unique identifier of an ad account.