Skip to main content

​
Endpoint

GET /api/v1/feeds/{platform}
Path parameters:
ParameterValues
platformgoogle, meta, openai

​
Basic Request

curl "https://app.alana.shopping/api/v1/feeds/google" \
  -H "X-API-Key: sk_live_your_api_key"

​
Format Options

PlatformDefault FormatAccept Header Override
googleapplication/xmlapplication/x-ndjson
metatext/csvapplication/x-ndjson
openaiapplication/jsonapplication/x-ndjson

​
NDJSON Streaming

For large catalogs, request NDJSON to process products one at a time: 
curl "https://app.alana.shopping/api/v1/feeds/google" \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Accept: application/x-ndjson"

​
ETag and Delta Feeds

Use ETag for efficient polling — only download a new feed when content has changed: 
# First request — save the ETag
curl -I "https://app.alana.shopping/api/v1/feeds/google" \
  -H "X-API-Key: sk_live_your_api_key"
# ETag: "abc123def456"

# Subsequent requests — skip download if unchanged
curl "https://app.alana.shopping/api/v1/feeds/google" \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "If-None-Match: \"abc123def456\""
# Returns 304 Not Modified if feed hasn't changed

​
Response Headers

HeaderDescription
ETagFeed content hash for conditional requests
Last-ModifiedTimestamp of last feed generation
X-Feed-Product-CountNumber of products in the feed
Cache-Controlmax-age=900 (15-minute cache)

​
Query Parameters

ParameterTypeDescription
catalog_idstringFilter to a specific catalog (optional)
limitintegerMax products per page (default: all)
offsetintegerPagination offset
Last modified on March 18, 2026