Product Catalog – Picture fetching logic

The Facebook Product Catalog, which stores information about the product items that you want to promote or sell across the Facebook ecosystem, is used to power various products such as Dynamic Ads, Collection Ads and Marketplace. Billions of product updates are sent to Facebook every day, but we don’t pull images for all products in inventory. The following FAQs cover some of the common scenarios.

When are images accessed?

When a feed upload is complete, we don’t schedule all items in the catalog to be fetched. We only schedule the article for image retrieval when an article has a pixel fire / app event or is used for ad recommendation. Until then, the status of a newly created item is “Not Retrieved”.

When the image URL of a previously fetched item is updated, we change the status of the item to Out of Date and reschedule it to fetch the image again. The item can remain in a stale state if the image retrieval request fails for any reason. Articles with outdated images are not filtered out of ad impressions. We will continue to display the previously retrieved images for these products.

When are images not retrieved?

  • If the item’s URL hasn’t changed, but the content behind the URL has changed (for example, the advertiser sometimes adds or removes the “SALE” sticker), the image won’t be retrieved again.
  • If the image get request failed due to various HTTP errors such as: B. Unavailable service, requested bug request, bug not found or when the advertiser throttles Facebook requests.
  • When the advertiser blocks the Facebook image crawler.
  • We’re throttling image fetching for items that change the image url without changing the content of the image.


It is not recommended to add a timestamp to the URL to ensure the images are downloaded. There is a high possibility that we will no longer reschedule image fetching for these items.

What are the different picture retrieval status?

  • If the item’s main image url could not be obtained, the main image and its additional images will not be updated, and the image retrieval status of that item will change to “Failed to Get”
  • If the main image could be retrieved but some of the additional images for the item could not be retrieved, the image retrieval status is set to partial retrieval.
  • Items for which no images have been obtained have a status of “Not Retrieved”.

What if I throttle image fetch requests from the Facebook image crawler, or if the requests failed for other reasons?

If the image retrieval fails consecutively, we will block the image retrieval request for that item for 12 hours. If the get requests continue to fail, there is a very high chance that we will not schedule them to get the image.

What other product-level statuses should I know?

Review of a product is planned to ensure that no guidelines are violated. The product verification status refers to the status of this integrity check. The products should be reviewed after a pixel fire, an app event or a product recommendation. We check all text fields and all images that are or can be made visible in an advertisement using dynamic templates. The review status changes to either “Approved” (article can be viewed to users) or “Rejected” (article appears to violate our guidelines. Users can object to it). When a previously reviewed product is updated, we reschedule it for review and the status of that product changes to Obsolete.

Comments are closed.