Ads and Commerce

Product Catalog Categories

Updated: May 18, 2019
Copy for LLM

Reading

Categories and associated assets within given product catalog.

Example

GET /v25.0/{product-catalog-id}/categories HTTP/1.1
Host: graph.facebook.com
If you want to learn how to use the Graph API, read our Using Graph API guide

Parameters

Parameter Description
categorization_criteria
enum {BRAND, CATEGORY, PRODUCT_TYPE}
Product property used to define categories
required
filter
A JSON-encoded rule
SELF_EXPLANATORY

Fields

Reading from this edge will return a JSON formatted result:
{
"data": [],
"paging": {}
}
data
A list of ProductCatalogCategory nodes.
paging
For more details about pagination, see the Graph API guide.

Error Codes

Error Code Description
100
Invalid parameter

Creating

/{product_catalog_id}/categories

You can make a POST request to categories edge from the following paths:
When posting to this edge, a ProductCatalogCategory will be created.

Parameters

Parameter Description
data
list<JSON object>
Array of category specifications
required

categorization_criteria enum {BRAND, CATEGORY, PRODUCT_TYPE}
required
criteria_value string
required
name UTF-8 string
supports emoji
description UTF-8 string
supports emoji
destination_uri URL
image_url URL
tokens JSON object {string : string}
Show child parameters

Return Type

Struct  {
updated: integer,
skipped: integer,
total: integer,
details:  Map  {
string:  List  [ Map  {
string: string}]},
}

Error Codes

Error Code Description
100
Invalid parameter

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.