The main criterion used is to maximize the possibility that the user that performed the search would convert to a lead. This means that the search result ranking is customized per user, so different users could see different results.

1. go to https://developers.facebook.com/tools/explorer/ with a developer account. The account must have admin access to the catalog.
2. request a token with ads_management permissions.
3. make a GET call to /{PRODUCT_FEED_ID}/uploads. Here you can retrieve the id of your last upload session (the topmost one)
4. make a POST call to /{UPLOAD_SESSION_ID}/error_report
5. make a GET call to /{UPLOAD_SESSION_ID}?fields=error_report

In case the report is not ready, repeat the last call after a few seconds. Otherwise you should find a URL that you can download (e.g with wget, curl, etc.). The downloaded file will contain the full error report.

If you want to automate this flow, you can use an app.

If you get the error: "Cannot access an object not managed by the business owning this app", please make sure that the app you're using belongs to the business (Business Settings > Account > Apps).

We suggest you to update the catalog daily. You should schedule the feed upload in replace mode, so that every day Facebook will read the whole feed again, updating listings with changes, adding the new ones, skipping the non updated ones and removing the deleted ones.

Description is a field limited to 5000 characters. It's crucial to ensure a high quality listing, and it should be used to add all the useful information about the listing. HTML is not supported, but you can use new line (\n) characters to better structure your description.

Facebook catalog scheduled upload could be set in two modes: update and replace. The easiest way to configure a catalog is to select the replace mode. In this way, the catalog will be fully replaced at every upload (e.g. daily). If you want to remove a listing from Marketplace, simply remove it from your feed, and at the next upload it will be marked as removed. The listing may still be visible into Marketplace for the 24 hours that follow the upload.

At the moment we share some basic daily metrics in CSV format, you can access them from your catalog's Settings page.

We try to publish your listings or associated updates as soon as possible. Anyway, for optimization purposes, this process is asynchronous, which means that you won't be able to see the updates straight away after the feed upload. Changes to the catalog could take up to 24 hours to show up.

Leads API always check the partner's webhook response. If it's not successful, or if it's delayed (e.g. for network congestion, webhook down, etc.) we send the lead again after some time. This way we make sure that no leads are lost. Anyway, the side effect of this protection mechanism is that you may receive duplicates from time to time. The suggestion is to implement a filter on your webhook code, so you can check if a lead has been already received and discard possible copies of it.