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

catalog_feeds

Get feed

Get a single feed 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.

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

get/catalogs/feeds/{feed_id}

Path parameters

feed_idstring required

Unique identifier of a feed.

Query parameters

ad_account_idstring

Unique identifier of an ad account.

Response

The request has succeeded.

Example response

{
  "id": "864344156814050986"
}

Changes

Changed in 10 of the 29 revisions of this API.3463

Jun 4, 2026v5b698c180678a46See the full diff
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the non-success response with the status 429
  response-non-success-status-added
- ○
  added the optional property oneOf[subschema #1: catalogs_retail_feed]/credentials to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #1: catalogs_retail_feed]/default_availability to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #1: catalogs_retail_feed]/default_currency to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #1: catalogs_retail_feed]/preferred_processing_schedule to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #2: catalogs_hotel_feed]/credentials to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #2: catalogs_hotel_feed]/default_currency to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #2: catalogs_hotel_feed]/preferred_processing_schedule to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #3: catalogs_creative_assets_feed]/credentials to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #3: catalogs_creative_assets_feed]/default_currency to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #3: catalogs_creative_assets_feed]/preferred_processing_schedule to the response with the 200 status
  response-optional-property-added
- ○
  removed CatalogsDbItem subschema #2: feed_fields from the oneOf[subschema #1: catalogs_retail_feed]/ response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed CatalogsDbItem subschema #2: feed_fields from the oneOf[subschema #2: catalogs_hotel_feed]/ response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed CatalogsDbItem subschema #2: feed_fields from the oneOf[subschema #3: catalogs_creative_assets_feed]/ response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/catalog_type to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/created_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/default_country to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/default_locale to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/format to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/id to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/location to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/name to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/status to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #1: catalogs_retail_feed]/updated_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/catalog_id to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/catalog_type to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/created_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/default_locale to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/format to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/id to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/location to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/name to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/status to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #2: catalogs_hotel_feed]/updated_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/catalog_id to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/catalog_type to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/created_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/default_country to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/default_locale to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/format to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/id to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/location to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/name to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/status to the response with the 200 status
  response-required-property-added
- ○
  added the required property oneOf[subschema #3: catalogs_creative_assets_feed]/updated_at to the response with the 200 status
  response-required-property-added
This revision also has 182 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 4, 2025v510f9eba4ad972See the full diff
- ○
  api tag catalog_feeds added
  api-tag-added
- ○
  api tag catalogs removed
  api-tag-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 14, 2024v589c27ed39cfd10See the full diff
- ○
  the endpoint scheme security client_credentials was added to the API
  api-security-added
- ○
  the response property oneOf[subschema #1: catalogs_retail_feed]/allOf[subschema #1: db_item]/created_at became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[subschema #1: catalogs_retail_feed]/allOf[subschema #1: db_item]/id became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[subschema #1: catalogs_retail_feed]/allOf[subschema #1: db_item]/updated_at became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[subschema #2: catalogs_hotel_feed]/allOf[subschema #1: db_item]/created_at became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[subschema #2: catalogs_hotel_feed]/allOf[subschema #1: db_item]/id became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[subschema #2: catalogs_hotel_feed]/allOf[subschema #1: db_item]/updated_at became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[subschema #3: catalogs_creative_assets_feed]/allOf[subschema #1: db_item]/created_at became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[subschema #3: catalogs_creative_assets_feed]/allOf[subschema #1: db_item]/id became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[subschema #3: catalogs_creative_assets_feed]/allOf[subschema #1: db_item]/updated_at became required for the status 200
  response-property-became-required
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 23, 2024v5f9321315766f121See the full diff
- ▲
  added CatalogsCreativeAssetsFeed to the response body oneOf list for the response status 200
  response-body-one-of-added
- ●
  added the new CREATIVE_ASSETS enum value to the oneOf[subschema #1: catalogs_retail_feed]/allOf[subschema #2: feed_fields]/catalog_type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new CREATIVE_ASSETS enum value to the oneOf[subschema #2: catalogs_hotel_feed]/allOf[subschema #2: feed_fields]/catalog_type response property for the response status 200
  response-property-enum-value-added
- ○
  added CREATIVE_ASSETS mapping keys to the response discriminator for the response status 200
  response-body-discriminator-mapping-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 17, 2023v50ff12596bafd12See the full diff
- ▲
  added CatalogsRetailFeed CatalogsHotelFeed to the response body oneOf list for the response status 200
  response-body-one-of-added
- ○
  removed CatalogsDbItem subschema #2: feed_fields from the response body allOf list for the response status 200
  response-body-all-of-removed
- ○
  added response discriminator for the response status 200
  response-body-discriminator-added
Feb 14, 2023v5be19b77aa78a1See the full diff
- ●
  added the new CN enum value to the allOf[subschema #2: feed_fields]/default_country response property for the response status 200
  response-property-enum-value-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 14, 2022v5e041d7b0cef01See the full diff
- ○
  added the new optional query request parameter ad_account_id
  new-optional-request-parameter
Apr 12, 2022v5723c511580441See the full diff
- ▲
  added the new path request parameter feed_id
  new-request-path-parameter
Apr 8, 2022v533ec8e7421c71See the full diff
- ●
  deleted the path request parameter feed_id
  request-parameter-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 8, 2022v5c561dee8c1371See the full diff
- ○
  endpoint added
  endpoint-added

Full history