Meta Commerce

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

Field	Description
`id`	Unique product identifier
`title`	Product name
`description`	Product description
`availability`	`in stock`, `out of stock`, `preorder`, `available for order`
`condition`	`new`, `used`, `refurbished`
`price`	Price with currency (e.g. `29.99 BRL`)
`link`	Product page URL
`image_link`	Product image URL
`brand`	Brand 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

const res = await fetch(
  "https://app.alana.shopping/api/v1/feeds/meta",
  { headers: { "X-API-Key": "sk_live_your_api_key" } }
);
const csv = await res.text();

import requests

res = requests.get(
    "https://app.alana.shopping/api/v1/feeds/meta",
    headers={"X-API-Key": "sk_live_your_api_key"},
)
with open("meta-catalog.csv", "w", encoding="utf-8") as f:
    f.write(res.text)

Field Mapping

Alana automatically maps your product data to Meta’s required fields:

Alana Field	Meta Field	Notes
`sku`	`id`
`name`	`title`	Truncated at 150 chars
`description`	`description`	Truncated at 9999 chars
`stock_status`	`availability`	Mapped to Meta values
`price`	`price`	Currency appended from workspace settings
`images[0].url`	`image_link`	First image used
`brand.name`	`brand`

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

⌘I

Overview

Workspace

Members

Brands

Dashboards

Catalogs

Products

Surfaces

AI Services

Billing

API Keys

Integrations

Reference

Search API v1

Platform Adapters

Analytics

Feed API

MCP Tools

Data Pipeline

Marketplace Hub

Platform Guides

Overview

Feed URL

CSV Format

Required Fields

Requesting the Feed

Field Mapping

Additional Images

Variants

​Overview

​Feed URL

​CSV Format

​Required Fields

​Requesting the Feed

​Field Mapping

​Additional Images

​Variants

Overview

Feed URL

CSV Format

Required Fields

Requesting the Feed

Field Mapping

Additional Images

Variants