product

This object type represents a product. This includes both virtual and physical products, but it typically represents items that are available in an online store.

Markup
 <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# product: http://ogp.me/ns/product#">
  <meta property="fb:app_id" content="302184056577324" /> 
  <meta property="og:type"   content="product" /> 
  <meta property="og:url"    content="Put your own URL to the object here" /> 
  <meta property="og:title"  content="Sample Product" /> 
  <meta property="og:image"  content="https://s-static.ak.fbcdn.net/images/devsite/attachment_blank.png" /> 
Create
/* make the API call */
FB.api(
    "/me/objects/product",
    "POST",
    {
        "object": "{\"fb:app_id\":\"302184056577324\",\"og:type\":\"product\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Product\",\"og:image\":\"https:\\\/\\\/s-static.ak.fbcdn.net\\\/images\\\/devsite\\\/attachment_blank.png\"}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"object": @"{\"fb:app_id\":\"302184056577324\",\"og:type\":\"product\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Product\",\"og:image\":\"https:\/\/s-static.ak.fbcdn.net\/images\/devsite\/attachment_blank.png\"}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/me/objects/product"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Bundle params = new Bundle();
params.putString("object", "{\"fb:app_id\":\"302184056577324\",\"og:type\":\"product\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Product\",\"og:image\":\"https:\/\/s-static.ak.fbcdn.net\/images\/devsite\/attachment_blank.png\"}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/me/objects/product",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'POST',
  '/me/objects/product',
  array (
    'object' => '{"fb:app_id":"302184056577324","og:type":"product","og:url":"Put your own URL to the object here","og:title":"Sample Product","og:image":"https:\\/\\/s-static.ak.fbcdn.net\\/images\\/devsite\\/attachment_blank.png"}',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
POST /v2.10/me/objects/product HTTP/1.1
Host: graph.facebook.com

object=%7B%22fb%3Aapp_id%22%3A%22302184056577324%22%2C%22og%3Atype%22%3A%22product%22%2C%22og%3Aurl%22%3A%22Put+your+own+URL+to+the+object+here%22%2C%22og%3Atitle%22%3A%22Sample+Product%22%2C%22og%3Aimage%22%3A%22https%3A%5C%2F%5C%2Fs-static.ak.fbcdn.net%5C%2Fimages%5C%2Fdevsite%5C%2Fattachment_blank.png%22%7D
curl -X POST \
     -d "object=%7B%22fb%3Aapp_id%22%3A%22302184056577324%22%2C%22og%3Atype%22%3A%22product%22%2C%22og%3Aurl%22%3A%22Put+your+own+URL+to+the+object+here%22%2C%22og%3Atitle%22%3A%22Sample+Product%22%2C%22og%3Aimage%22%3A%22https%3A%5C%2F%5C%2Fs-static.ak.fbcdn.net%5C%2Fimages%5C%2Fdevsite%5C%2Fattachment_blank.png%22%7D" \
        https://graph.facebook.com/v2.10/me/objects/product
Read
/* make the API call */
FB.api(
    "/me/objects/product",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/me/objects/product"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/me/objects/product",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/me/objects/product'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
GET /v2.10/me/objects/product HTTP/1.1
Host: graph.facebook.com
curl https://graph.facebook.com/v2.10/me/objects/product
Update
/* make the API call */
FB.api(
    "/id_from_create_call",
    "POST",
    {
        "object": "{\"fb:app_id\":\"302184056577324\",\"og:type\":\"product\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Product\",\"og:image\":\"https:\\\/\\\/s-static.ak.fbcdn.net\\\/images\\\/devsite\\\/attachment_blank.png\"}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"object": @"{\"fb:app_id\":\"302184056577324\",\"og:type\":\"product\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Product\",\"og:image\":\"https:\/\/s-static.ak.fbcdn.net\/images\/devsite\/attachment_blank.png\"}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/id_from_create_call"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Bundle params = new Bundle();
params.putString("object", "{\"fb:app_id\":\"302184056577324\",\"og:type\":\"product\",\"og:url\":\"Put your own URL to the object here\",\"og:title\":\"Sample Product\",\"og:image\":\"https:\/\/s-static.ak.fbcdn.net\/images\/devsite\/attachment_blank.png\"}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/id_from_create_call",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'POST',
  '/id_from_create_call',
  array (
    'object' => '{"fb:app_id":"302184056577324","og:type":"product","og:url":"Put your own URL to the object here","og:title":"Sample Product","og:image":"https:\\/\\/s-static.ak.fbcdn.net\\/images\\/devsite\\/attachment_blank.png"}',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
POST /v2.10/id_from_create_call HTTP/1.1
Host: graph.facebook.com

object=%7B%22fb%3Aapp_id%22%3A%22302184056577324%22%2C%22og%3Atype%22%3A%22product%22%2C%22og%3Aurl%22%3A%22Put+your+own+URL+to+the+object+here%22%2C%22og%3Atitle%22%3A%22Sample+Product%22%2C%22og%3Aimage%22%3A%22https%3A%5C%2F%5C%2Fs-static.ak.fbcdn.net%5C%2Fimages%5C%2Fdevsite%5C%2Fattachment_blank.png%22%7D
curl -X POST \
     -d "object=%7B%22fb%3Aapp_id%22%3A%22302184056577324%22%2C%22og%3Atype%22%3A%22product%22%2C%22og%3Aurl%22%3A%22Put+your+own+URL+to+the+object+here%22%2C%22og%3Atitle%22%3A%22Sample+Product%22%2C%22og%3Aimage%22%3A%22https%3A%5C%2F%5C%2Fs-static.ak.fbcdn.net%5C%2Fimages%5C%2Fdevsite%5C%2Fattachment_blank.png%22%7D" \
        https://graph.facebook.com/v2.10/id_from_create_call
Delete
/* make the API call */
FB.api(
    "/id_from_create_call",
    "DELETE",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/id_from_create_call"
                                      parameters:params
                                      HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/id_from_create_call",
    null,
    HttpMethod.DELETE,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'DELETE',
  '/id_from_create_call'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
DELETE /v2.10/id_from_create_call HTTP/1.1
Host: graph.facebook.com
curl -X DELETE \
     -d "" \
        https://graph.facebook.com/v2.10/id_from_create_call
Properties
NameTypeDescription
FIELDS
product:age_groupEnumThe target age group of the product, one of 'kids' or 'adult'
product:availabilityEnumThe availability of the product, one of 'instock', 'oos', or 'pending'
product:brandStringThe brand of the product or its original manufacturer
product:categoryStringA category for the product
product:colorStringA color describing the product
product:conditionEnumClassThe condition of the item, one of 'new', 'refurbished', or 'used'
product:eanProductIDAn International Article Number, or European Article Number (EAN), for the product
product:expiration_timeDateTimeA time representing when the product expired (or will expire)
product:is_product_shareableBooleanDoes the associated story have a share button on it
product:isbnProductIDA International Standard Book Number (ISBN) for the product, intended for when it is a book
product:materialStringA description of the material used to make the product
product:mfr_part_noStringA manufacturer's part number for the product
product:original_priceArray<Currency>The original price of the product
product:original_price:amountFloatAn array of the values of the original prices of the product
product:original_price:currencyStringAn array of the currencies of the original prices of the product
product:patternStringA description of the pattern used on the product
product:plural_titleStringA title to be used to describe multiple items of this product
product:pretax_priceArray<Currency>The pre-tax price of the product
product:pretax_price:amountFloatAn array of the values of the pre-tax prices of the product
product:pretax_price:currencyStringAn array of the currencies of the pre-tax prices of the product
product:priceArray<Currency>The price of the product
product:price:amountFloatAn array of the values of the prices of the product
product:price:currencyStringAn array of the currencies of the prices of the product
product:product_linkURLA link to find out more about the product
product:purchase_limitIntegerThe maximum number of times a person can purchase the product
product:retailerProfileA Facebook ID (or reference to the profile) of the retailer of the product
product:retailer_categoryStringThe retailer's category for the product
product:retailer_part_noStringA retailer's part number for the product
product:retailer_titleStringThe name of the retailer of the product
product:sale_priceCurrencyThe sale price of the product
product:sale_price:amountFloatThe value of the sale price of the product
product:sale_price:currencyStringThe currency of the sale price of the product
product:sale_price_datesDateTimeRangeThe date range for which the sale prices is valid
product:sale_price_dates:startDateTimeThe starting date and time of the sale
product:sale_price_dates:endDateTimeThe ending date and time of the sale
product:shipping_costArray<Currency>The shipping cost of the product
product:shipping_cost:amountFloatAn array of the values of the shipping costs for the product
product:shipping_cost:currencyStringAn array of the currencies of the shipping costs for the product
product:shipping_weightQuantityThe shipping weight of the product
product:shipping_weight:valueFloatA value representing the shipping weight of the product
product:shipping_weight:unitsEnumThe units of the shipping weight of the product
product:sizeStringA size describing the product (such as 'S', 'M', 'L')
product:target_genderEnumThe target gender of the product, one of 'female', 'male', or 'unisex'
product:upcProductIDA Universal Product Code (UPC) for the product
product:weightQuantityThe weight of the product
product:weight:valueFloatA value representing the weight of the product
product:weight:unitsEnumThe units of the weight of the product
INHERITED FIELDS
al:androidArray<Struct>
al:android:urlAppsite
al:android:packageAndroidPath
al:android:app_nameString
al:android:classString
al:iosArray<IosApplink>
al:ios:urlAppsite
al:ios:app_store_idInteger
al:ios:app_nameString
al:ipadArray<IosApplink>
al:ipad:urlAppsite
al:ipad:app_store_idInteger
al:ipad:app_nameString
al:iphoneArray<IosApplink>
al:iphone:urlAppsite
al:iphone:app_store_idInteger
al:iphone:app_nameString
al:webStruct
al:web:urlURL
al:web:should_fallbackBoolean
al:windowsArray<Struct>
al:windows:urlAppsite
al:windows:package_family_nameString
al:windows:app_idGuid
al:windows:app_nameString
al:windows_phoneArray<Struct>
al:windows_phone:urlAppsite
al:windows_phone:app_idGuid
al:windows_phone:app_nameString
al:windows_universalArray<Struct>
al:windows_universal:urlAppsite
al:windows_universal:package_family_nameString
al:windows_universal:app_idGuid
al:windows_universal:app_nameString
fb:adminsArray<Facebook ID>An array of the Facebook IDs of the app's administrators
fb:app_idFacebook IDA Facebook app ID
fb:pagesArray<Facebook ID>
fb:profile_idProfileThe Facebook ID of a user that can be followed
og:audioArray<Audio>
og:audio:urlStringThe URL of an audio resource associated with the object
og:audio:secure_urlURLAn alternate URL to use if an audio resource requires HTTPS
og:audio:typeStringThe MIME type of an audio resource associated with the object
og:descriptionStringA short description of the object
og:determinerEnumThe word that appears before the object's title in a sentence. This is an list of words from 'a', 'an', 'the', ' "" ', or 'auto'. If 'auto' is chosen, the consumer of the object will chose between 'a' or 'an'. The default is the blank, "".
og:imageArray<Image>
og:image:urlURLThe URL of an image resource associated with the object
og:image:secure_urlURLAn alternate URL to use if an image resource requires HTTPS
og:image:typeStringThe MIME type of an image resource
og:image:widthIntegerThe width of an image resource in pixels
og:image:heightIntegerThe height of an image resource in pixels
og:image:altString
og:image:user_generatedBoolean
og:localeLocaleNot supported
og:locale:localeEnum
og:locale:alternateArray<Enum>Not supported
og:restrictionsRestrictions
og:restrictions:countryStruct
og:restrictions:country:allowedArray<Country>A whitelist country restriction for the object using a two-letter country code, such as 'US' (may not be used with og:restrictions:country:disallowed)
og:restrictions:country:disallowedArray<Country>A blacklist country restriction for the object using a two-letter country code, such as 'US' (may not be used with og:restrictions:country:allowed)
og:restrictions:ageAgeAn age restriction for the object, such as '13+', '18+'
og:restrictions:contentArray<Content>A content restriction for the object, such as 'alcohol' (the only currently supported value)
og:rich_attachmentBoolean
og:see_alsoArray<URL>An array of URLs of related resources
og:site_nameStringNot supported
og:titleStringThe title of the object as it should appear in the graph
og:ttlInteger
og:typeStringThe type of the object, such as 'article'
og:updated_timeDateTimeThe time when the object was last updated
og:urlURLThe canonical URL of the object, used as its ID in the graph
og:videoArray<Video>
og:video:urlURLThe URL of a video resource associated with the object
og:video:secure_urlURLAn alternate URL to use if a video resource requires HTTPS
og:video:typeStringThe MIME type of a video resource associated with the object
og:video:widthIntegerThe width of a video resource associated with the object in pixels
og:video:heightIntegerThe height of a video resource associated with the object in pixels