Ads and Commerce
Ads and Commerce
Resources
Product Catalog Media Titles
Updated: Apr 17, 2026
The Product Catalog Media Titles edge allows you to list and create media title items (movies, TV shows, music) in a product catalog.
Permissions
To use this API, your app needs the following permission:
catalog_management
Reading
To list media title items in a catalog, send a
GET request:GET /v25.0/{product-catalog-id}/media_titles HTTP/1.1
Host: graph.facebook.com
Parameters
| Parameter | Type | Description |
|---|---|---|
filter | string | Optional. JSON-encoded WCA filter rule for filtering media titles. For example: {"media_category":{"eq":"Movie"}}. See Product Set for the full list of filter operators. |
summary | boolean | Optional. When true, includes a summary object with total_count in the response. |
limit | integer | Optional. Maximum number of items to return per page. |
before | string | Optional. Cursor for backward pagination. |
after | string | Optional. Cursor for forward pagination. |
Fields
Reading from this edge will return a JSON formatted result:
{
"data": [],
"paging": {},
"summary": {}
}
data
A list of Media Title nodes. See the Media Title reference for the full list of fields.
paging
For more details about pagination, see the Graph API guide.
summary
Aggregated information about the edge, such as counts. Specify
summary=true as a query parameter to include this in the response.| Field | Type | Description |
|---|---|---|
total_count | integer | Total number of items in the catalog. |
Creating
To create a media title item in a catalog, send a
POST request:POST /v25.0/{product-catalog-id}/media_titles HTTP/1.1
Host: graph.facebook.com
Content-Type: application/json
{
"retailer_id": "media-001",
"name": "The Great Adventure",
"description": "An epic journey across the world",
"image_url": "https://example.com/poster.jpg",
"url": "https://example.com/the-great-adventure",
"media_category": "Movie",
"genre": ["Action", "Adventure"],
"content_rating": "PG-13"
}
Parameters
The following fields are required:
retailer_id, name, description, image_url, url. All other fields are optional.For the full list of supported fields, see the Media Title node — Fields.
Response
{
"id": "1234567890"
}
Updating
You can’t perform this operation on this node. To update individual media title items, use the Media Title node.
Deleting
You can’t perform this operation on this node. To delete individual media title items, use the Media Title node.
Did you find this page helpful?
