Skip to main content

​
Overview

The Meta feed returns a CSV file compatible with Meta’s Commerce Manager catalog import. Use it to sync your Alana catalog with Facebook Shops, Instagram Shopping, and Meta Advantage+ catalogs.

​
Feed URL

GET /api/v1/feeds/meta
Add this URL in Meta Commerce Manager → Catalog → Data Sources → Scheduled Feed.

​
CSV Format

id,title,description,availability,condition,price,link,image_link,brand,google_product_category
SKU-001,Blue Cotton T-Shirt,"100% cotton, pre-shrunk",in stock,new,29.99 BRL,https://yourstore.com/p/blue-tshirt,https://cdn.yourstore.com/blue-tshirt.jpg,YourBrand,212
SKU-002,Red Sneakers,Running shoes with cushioned sole,in stock,new,199.90 BRL,https://yourstore.com/p/red-sneakers,https://cdn.yourstore.com/red-sneakers.jpg,YourBrand,187

​
Required Fields

FieldDescription
idUnique product identifier
titleProduct name
descriptionProduct description
availabilityin stock, out of stock, preorder, available for order
conditionnew, used, refurbished
pricePrice with currency (e.g. 29.99 BRL)
linkProduct page URL
image_linkProduct image URL
brandBrand name

​
Requesting the Feed

curl "https://app.alana.shopping/api/v1/feeds/meta" \
  -H "X-API-Key: sk_live_your_api_key" \
  -o meta-catalog.csv

​
Field Mapping

Alana automatically maps your product data to Meta’s required fields:
Alana FieldMeta FieldNotes
skuid
nametitleTruncated at 150 chars
descriptiondescriptionTruncated at 9999 chars
stock_statusavailabilityMapped to Meta values
pricepriceCurrency appended from workspace settings
images[0].urlimage_linkFirst image used
brand.namebrand

​
Additional Images

Meta supports up to 10 additional images via additional_image_link columns. Alana includes all product images beyond the first in these columns automatically.

​
Variants

For products with variants (size, color), Alana generates one row per variant with item_group_id set to the parent product SKU, allowing Meta to group them correctly in the catalog.
Last modified on March 18, 2026