List feeds

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

Fetch feeds 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.

For Retail partners, refer to Before you get started with Catalogs. For Hotel parterns, refer to Pinterest API for shopping.

Request Params

KeyDatatypeRequiredDescription
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.
catalog_idnumberFilter entities for a given catalog_id. If not given, all catalogs are considered.
ad_account_idnumberUnique identifier of an ad account.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;items&quot;:[{&quot;credentials&quot;:{&quot;username&quot;:&quot;\u003cstring\u003e&quot;,&quot;password&quot;:&quot;\u003cstring\u003e&quot;},&quot;default_availability&quot;:&quot;OUT_OF_STOCK&quot;,&quot;default_country&quot;:&quot;LS&quot;,&quot;default_currency&quot;:&quot;MOP&quot;,&quot;default_locale&quot;:&quot;\u003cstring\u003e&quot;,&quot;format&quot;:&quot;XML&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;preferred_processing_schedule&quot;:{&quot;time&quot;:&quot;05:38&quot;,&quot;timezone&quot;:&quot;Europe/Kirov&quot;},&quot;status&quot;:&quot;INACTIVE&quot;,&quot;catalog_type&quot;:&quot;RETAIL&quot;,&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;},{&quot;credentials&quot;:{&quot;username&quot;:&quot;\u003cstring\u003e&quot;,&quot;password&quot;:&quot;\u003cstring\u003e&quot;},&quot;default_availability&quot;:&quot;PREORDER&quot;,&quot;default_country&quot;:&quot;PK&quot;,&quot;default_currency&quot;:&quot;BZD&quot;,&quot;default_locale&quot;:&quot;\u003cstring\u003e&quot;,&quot;format&quot;:&quot;CSV&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;preferred_processing_schedule&quot;:{&quot;time&quot;:&quot;16:45&quot;,&quot;timezone&quot;:&quot;Europe/Tirane&quot;},&quot;status&quot;:&quot;ACTIVE&quot;,&quot;catalog_type&quot;:&quot;HOTEL&quot;,&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;}],&quot;bookmark&quot;:&quot;\u003cstring\u003e&quot;}