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
Key | Datatype | Required | Description |
---|---|---|---|
bookmark | string | Cursor used to fetch the next page of items | |
page_size | number | Maximum 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_id | number | Filter entities for a given catalog_id. If not given, all catalogs are considered. | |
ad_account_id | number | Unique identifier of an ad account. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"items":[{"credentials":{"username":"\u003cstring\u003e","password":"\u003cstring\u003e"},"default_availability":"OUT_OF_STOCK","default_country":"LS","default_currency":"MOP","default_locale":"\u003cstring\u003e","format":"XML","location":"\u003cstring\u003e","name":"\u003cstring\u003e","preferred_processing_schedule":{"time":"05:38","timezone":"Europe/Kirov"},"status":"INACTIVE","catalog_type":"RETAIL","created_at":"\u003cdateTime\u003e","id":"\u003cstring\u003e","updated_at":"\u003cdateTime\u003e"},{"credentials":{"username":"\u003cstring\u003e","password":"\u003cstring\u003e"},"default_availability":"PREORDER","default_country":"PK","default_currency":"BZD","default_locale":"\u003cstring\u003e","format":"CSV","location":"\u003cstring\u003e","name":"\u003cstring\u003e","preferred_processing_schedule":{"time":"16:45","timezone":"Europe/Tirane"},"status":"ACTIVE","catalog_type":"HOTEL","created_at":"\u003cdateTime\u003e","id":"\u003cstring\u003e","updated_at":"\u003cdateTime\u003e"}],"bookmark":"\u003cstring\u003e"}