IG User Available Catalogs

Updated: Mar 18, 2026

Copy for LLM

Represents a collection of product catalogs in an IG User’s Instagram Shop⁠. See Product Tagging guide for complete usage details.

Available for the Instagram API with Facebook Login.

Creating

This operation is not supported.

Reading

GET /<IG_USER_ID>/available_catalogs

Get the product catalog in an IG User’s Instagram Shop⁠.

Limitations

Instagram Creator accounts are not supported.

Stories, Instagram TV, Reels, Live, and Mentions are not supported.

Only returns data on a single catalog because Instagram Shops are limited to a single catalog.

Collaborative catalogs (shopping partner or affiliate creator catalogs) are not supported.

Requirements

Type	Requirement
Access Tokens	User
Business Roles⁠	The app user must have an admin role on the Business Manager⁠ that owns the IG User’s Instagram Shop⁠.
Instagram Shop⁠	The IG User must have an approved Instagram Shop⁠ with a product catalog containing products.
Permissions	`catalog_managementinstagram_basicinstagram_shopping_tag_products` If the app user was granted a role via the Business Manager on the Facebook Page connected to the targeted IG User, you will also need one of: `ads_managementads_read`

Request Syntax

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>/available_catalogs
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Path Parameters

Placeholder	Value
`<API_VERSION>`	API version
`<IG_USER_ID>`	Required. App user’s app-scoped user ID.

Query String Parameters

Key	Placeholder	Value
`access_token`	`<ACCESS_TOKEN>`	Required. App user’s User access token.
`fields`	`<LIST_OF_FIELDS>`	Comma-separated list of catalog fields you want returned for each catalog in the result set.

Response

A JSON-formatted object containing the data you requested.

{
  "data": [
    {
      "catalog_id": "{catalog-id}",
      "catalog_name": "{catalog-name}",
      "shop_name": "{shop-name}",
      "product_count": {product-count}
    }
  ]
}

Response Contents

Property	Value
`catalog_id`	Catalog ID.
`catalog_name`	Catalog name.
`shop_name`	Shop name.
`product_count`	Number of products in catalog. Includes all products regardless of review status.

cURL Example

Request

curl -i -X GET \
 "https://graph.facebook.com/v26.0/90010177253934/available_catalogs?access_token=EAAOc..."

Response

{
  "data": [
    {
      "catalog_id": "960179311066902",
      "catalog_name": "Jay's Favorite Snacks",
      "shop_name": "Jay's Bespoke",
      "product_count": 11
    }
  ]
}

Updating

This operation is not supported.

Deleting

This operation is not supported.