Represents products and product variants that match a given search string in an IG User's Instagram Shop product catalog. See Product Tagging guide for complete usage details.
This operation is not supported.
GET /{ig-user-id}/catalog_product_search
Get a collection of products that match a given search string within the targeted IG User's Instagram Shop catalog.
review_status
of rejected
will be returned, however, IG Media cannot be tagged with rejected products.review_status
of approved
. This field is returned for each product by default when you get an app user's eligible products.Type | Requirement |
---|---|
The app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop. | |
The IG User must have an approved Instagram Shop with a product catalog containing products. | |
If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: |
GET https://graph.facebook.com/{api-version}/{ig-user-id}/catalog_product_search ?catalog_id={catalog-id} &q={q} &access_token={access-token}
Placeholder | Value |
---|---|
| API version. |
| Required. App user's app-scoped user ID. |
Key | Placeholder | Value |
---|---|---|
|
| Required. App user's User access token. |
|
| Required. ID of catalog to search. |
|
| A string to search for in each product's name or SKU number (SKU numbers can be added in the Content ID column in the catalog management interface). If no string is specified, all tag-eligible products will be returned. |
A JSON-formatted object containing an array of tag-eligible products and their metadata. Supports cursor-based pagination.
{ "data": [ { "product_id": {product-id}, "merchant_id": {merchant-id}, "product_name": "{product-name}", "image_url": "{image-url}", "retailer_id": "{retailer-id}", "review_status": "{review-status}", "is_checkout_flow": {is-checkout-flow} } ] }
Property | Value |
---|---|
| Product ID. |
| Merchant ID. |
| Product name. |
| Product image URL. |
| Retailer ID. |
| Review status. Values can be |
| If |
| Product IDs ( |
curl -i -X GET \
"https://graph.facebook.com/v19.0
/90010177253934/catalog_product_search?catalog_id=960179311066902&q=gummy&access_token=EAAOc"
{ "data": [ { "product_id": 3231775643511089, "merchant_id": 90010177253934, "product_name": "Gummy Wombats", "image_url": "https://scont...", "retailer_id": "oh59p9vzei", "review_status": "approved", "is_checkout_flow": true, "product_variants": [ { "product_id": 5209223099160494 }, { "product_id": 7478222675582505, "variant_name": "Green Gummy Wombats" } ] } ] }
This operation is not supported.
This operation is not supported.