Meta Developer Docs

Appearance

Fresh 2026

Product Group Products ​

Reading ​

Products for a given product group

Example ​

HTTPPHP SDKJavaScript SDKAndroid SDKiOS SDK Graph API Explorer

GET /v25.0/{product-group-id}/products HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{product-group-id}/products',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{product-group-id}/products",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{product-group-id}/products",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
                               initWithGraphPath:@"/{product-group-id}/products"\
                                      parameters:params\
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,\
                                      id result,\
                                      NSError *error) {\
    // Handle the result\
}];

If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters ​

This endpoint doesn't have any parameters.

Fields ​

Reading from this edge will return a JSON formatted result:

{
    "data": [],
    "paging": {}
}

data ​

A list of ProductItem nodes.

paging ​

For more details about pagination, see the Graph API guide.

Error Codes ​

ErrorDescription
100Invalid parameter

Creating ​

You can make a POST request to products edge from the following paths:

  • /{product_group_id}/products

When posting to this edge, a ProductItem will be created.

Parameters ​

ParameterDescription
additional_image_urls<br>list<URL>Additional product image URLs
additional_variant_attributes<br>JSON object {string : string}Additional attributes to distinguish the product in its variant group (ex: {"Scent" : "Fruity", "Style" : "Classic"})
age_group<br>enum {adult, all ages, infant, kids, newborn, teen, toddler}age_group
android_app_name<br>stringThe name of the app (suitable for display)
android_class<br>stringA fully-qualified Activity class name for intent generation
android_package<br>stringA fully-qualified package name for intent generation
android_url<br>stringA custom scheme for the Android app
availability<br>enum{in stock, out of stock, preorder, available for order, discontinued, pending, mark_as_sold, mark_as_expired}Default value: in stock<br>Availability of the product item
brand<br>stringBrand of the product item
category<br>stringCategory of the product item. This is a required field
checkout_url<br>URLURL to add product item to cart and directly to checkout
color<br>stringColor of the product item
commerce_tax_category<br>enum{FB_ANIMAL, FB_ANIMAL_SUPP, FB_APRL, FB_APRL_ACCESSORIES, FB_APRL_ATHL_UNIF, FB_APRL_CASES, FB_APRL_CLOTHING, FB_APRL_COSTUME, FB_APRL_CSTM, FB_APRL_FORMAL, FB_APRL_HANDBAG, FB_APRL_JEWELRY, FB_APRL_SHOE, FB_APRL_SHOE_ACC, FB_APRL_SWIM, FB_APRL_SWIM_CHIL, FB_APRL_SWIM_CVR, FB_ARTS, FB_ARTS_HOBBY, FB_ARTS_PARTY, FB_ARTS_PARTY_GIFT_CARD, FB_ARTS_TICKET, FB_BABY, FB_BABY_BATH, FB_BABY_BLANKET, FB_BABY_DIAPER, FB_BABY_GIFT_SET, FB_BABY_HEALTH, FB_BABY_NURSING, FB_BABY_POTTY_TRN, FB_BABY_SAFE, FB_BABY_TOYS, FB_BABY_TRANSPORT, FB_BABY_TRANSPORT_ACC, FB_BAGS, FB_BAGS_BKPK, FB_BAGS_BOXES, FB_BAGS_BRFCS, FB_BAGS_CSMT_BAG, FB_BAGS_DFFL, FB_BAGS_DIPR, FB_BAGS_FNNY, FB_BAGS_GRMT, FB_BAGS_LUG_ACC, FB_BAGS_LUGG, FB_BAGS_MSGR, FB_BAGS_TOTE, FB_BAGS_TRN_CAS, FB_BLDG, FB_BLDG_ACC, FB_BLDG_CNSMB, FB_BLDG_FENCE, FB_BLDG_FUEL_TNK, FB_BLDG_HT_VNT, FB_BLDG_LOCK, FB_BLDG_MATRL, FB_BLDG_PLMB, FB_BLDG_PUMP, FB_BLDG_PWRS, FB_BLDG_S_ENG, FB_BLDG_STR_TANK, FB_BLDG_TL_ACC, FB_BLDG_TOOL, FB_BUSIND, FB_BUSIND_ADVERTISING, FB_BUSIND_AGRICULTURE, FB_BUSIND_AUTOMATION, FB_BUSIND_HEAVY_MACH, FB_BUSIND_LAB, FB_BUSIND_MEDICAL, FB_BUSIND_RETAIL, FB_BUSIND_SANITARY_CT, FB_BUSIND_SIGN, FB_BUSIND_STORAGE, FB_BUSIND_STORAGE_ACC, FB_BUSIND_WORK_GEAR, FB_CAMERA_ACC, FB_CAMERA_CAMERA, FB_CAMERA_OPTIC, FB_CAMERA_OPTICS, FB_CAMERA_PHOTO, FB_ELEC, FB_ELEC_ACC, FB_ELEC_ARCDADE, FB_ELEC_AUDIO, FB_ELEC_CIRCUIT, FB_ELEC_COMM, FB_ELEC_COMPUTER, FB_ELEC_GPS_ACC, FB_ELEC_GPS_NAV, FB_ELEC_GPS_TRK, FB_ELEC_MARINE, FB_ELEC_NETWORK, FB_ELEC_PART, FB_ELEC_PRINT, FB_ELEC_RADAR, FB_ELEC_SFTWR, FB_ELEC_SPEED_RDR, FB_ELEC_TELEVISION, FB_ELEC_TOLL, FB_ELEC_VID_GM_ACC, FB_ELEC_VID_GM_CNSL, FB_ELEC_VIDEO, FB_FOOD, FB_FURN, FB_FURN_BABY, FB_FURN_BENCH, FB_FURN_CART, FB_FURN_CHAIR, FB_FURN_CHAIR_ACC, FB_FURN_DIVIDE, FB_FURN_DIVIDE_ACC, FB_FURN_ENT_CTR, FB_FURN_FUTN, FB_FURN_FUTN_PAD, FB_FURN_OFFICE, FB_FURN_OFFICE_ACC, FB_FURN_OTTO, FB_FURN_OUTDOOR, FB_FURN_OUTDOOR_ACC, FB_FURN_SETS, FB_FURN_SHELVE_ACC, FB_FURN_SHLF, FB_FURN_SOFA, FB_FURN_SOFA_ACC, FB_FURN_STORAGE, FB_FURN_TABL, FB_FURN_TABL_ACC, FB_GENERIC_TAXABLE, FB_HLTH, FB_HLTH_HLTH, FB_HLTH_JWL_CR, FB_HLTH_LILP_BLM, FB_HLTH_LTN_SPF, FB_HLTH_PRSL_CR, FB_HLTH_SKN_CR, FB_HMGN, FB_HMGN_BATH, FB_HMGN_DCOR, FB_HMGN_EMGY, FB_HMGN_FPLC, FB_HMGN_FPLC_ACC, FB_HMGN_GS_SFT, FB_HMGN_HS_ACC, FB_HMGN_HS_APP, FB_HMGN_HS_SPL, FB_HMGN_KTCN, FB_HMGN_LAWN, FB_HMGN_LGHT, FB_HMGN_LINN, FB_HMGN_LT_ACC, FB_HMGN_OTDR, FB_HMGN_POOL, FB_HMGN_SCTY, FB_HMGN_SMK_ACC, FB_HMGN_UMBR, FB_HMGN_UMBR_ACC, FB_MDIA, FB_MDIA_BOOK, FB_MDIA_DVDS, FB_MDIA_MAG, FB_MDIA_MANL, FB_MDIA_MUSC, FB_MDIA_PRJ_PLN, FB_MDIA_SHT_MUS, FB_OFFC, FB_OFFC_BKAC, FB_OFFC_CRTS, FB_OFFC_DSKP, FB_OFFC_EQIP, FB_OFFC_FLNG, FB_OFFC_GNRL, FB_OFFC_INSTM, FB_OFFC_LP_DSK, FB_OFFC_MATS, FB_OFFC_NM_PLT, FB_OFFC_PPR_HNDL, FB_OFFC_PRSNT_SPL, FB_OFFC_SEALR, FB_OFFC_SHIP_SPL, FB_RLGN, FB_RLGN_CMNY, FB_RLGN_ITEM, FB_RLGN_WEDD, FB_SFTWR, FB_SFWR_CMPTR, FB_SFWR_DGTL_GD, FB_SFWR_GAME, FB_SHIPPING, FB_SPOR, FB_SPORT_ATHL, FB_SPORT_ATHL_CLTH, FB_SPORT_ATHL_SHOE, FB_SPORT_ATHL_SPRT, FB_SPORT_EXRCS, FB_SPORT_INDR_GM, FB_SPORT_OTDR_GM, FB_TOYS, FB_TOYS_EQIP, FB_TOYS_GAME, FB_TOYS_PZZL, FB_TOYS_TMRS, FB_TOYS_TOYS, FB_VEHI, FB_VEHI_PART}commerce_tax_category
condition<br>enum{new, refurbished, used, used_like_new, used_good, used_fair, cpo, open_box_new}Default value: new<br>The condition of the product item
currency<br>ISO 4217 Currency CodeCurrency for the product item<br>Required
custom_data<br>dictionary { string : <string> }TBD
custom_label_0<br>stringAn optional custom label to associate with the product item. Max size: 100
custom_label_1<br>stringAn optional custom label to associate with the product item. Max size: 100
custom_label_2<br>stringAn optional custom label to associate with the product item. Max size: 100
custom_label_3<br>stringAn optional custom label to associate with the product item. Max size: 100
custom_label_4<br>stringAn optional custom label to associate with the product item. Max size: 100
custom_number_0<br>int64custom_number_0
custom_number_1<br>int64custom_number_1
custom_number_2<br>int64custom_number_2
custom_number_3<br>int64custom_number_3
custom_number_4<br>int64custom_number_4
description<br>stringDescription of the product item. Max size: 5000<br>Supports Emoji
expiration_date<br>stringItem's expiration date (YYYY-MM-DD)
fb_product_category<br>stringThe facebook product category specified by the seller.
gender<br>enum{female, male, unisex}Gender the product item is targeted towards
gtin<br>stringGlobal trade ID of the product item
image_url<br>URIURL of the product image<br>Required
inventory<br>int64Inventory count for the product item
ios_app_name<br>stringThe name of the app (suitable for display)
ios_app_store_id<br>int64The app ID for the App Store
ios_url<br>stringA custom scheme for the iOS app
ipad_app_name<br>stringThe name of the app (suitable for display)
ipad_app_store_id<br>int64The app ID for the App Store
ipad_url<br>stringA custom scheme for the iPhone app
iphone_app_name<br>stringThe name of the app (suitable for display)
iphone_app_store_id<br>int64The app ID for the App Store
iphone_url<br>stringA custom scheme for the iPhone app
launch_date<br>stringlaunch_date
manufacturer_part_number<br>stringManufacturer's ID for the product item
marked_for_product_launch<br>enum{default, marked, not_marked}marked_for_product_launch
material<br>stringMaterial of the product item<br>Max size: 200
mobile_link<br>URILink to a mobile-optimized external product page
name<br>stringName/title of the product item<br>RequiredSupports Emoji
ordering_index<br>int64Index used for ordering items within a group
pattern<br>stringPattern of the product item
price<br>int64Price of the item with 2 digits added for cents (ex: use "100" for 1 or "599" for 5.99)<br>Required
product_priority_0<br>floatproduct_priority_0
product_priority_1<br>floatproduct_priority_1
product_priority_2<br>floatproduct_priority_2
product_priority_3<br>floatproduct_priority_3
product_priority_4<br>floatproduct_priority_4
product_type<br>stringRetailer defined category of the product item. Max size: 750
quantity_to_sell_on_facebook<br>int64quantity_to_sell_on_facebook
retailer_id<br>stringA unique identifier for this item (which can be a variant for a product)<br>Required
return_policy_days<br>int64Return Policy Days
sale_price<br>int64Sale price of the item with 2 digits added for cents (ex: use "100" for 1 or "599" for 5.99)
sale_price_end_date<br>datetimeDate when the sale price ends
sale_price_start_date<br>datetimeDate when the sale price starts
short_description<br>stringA brief description of the product
size<br>stringSize of the product item
start_date<br>stringDate when the product started to exist
url<br>URIURL of the product item
visibility<br>enum{staging, published}Default value: published<br>Visibility of the product item
windows_phone_app_id<br>stringThe app ID (a GUID) for app store
windows_phone_app_name<br>stringThe name of the app (suitable for display)
windows_phone_url<br>stringA custom scheme for the Windows Phone app

Return Type ​

This endpoint supports read-after-write and will read the node represented by id in the return type.

Struct {

id: numeric string,

}

Error Codes ​

ErrorDescription
100Invalid parameter

Updating ​

You can't perform this operation on this endpoint.

Deleting ​

You can't perform this operation on this endpoint.