Skip to main content

​
Overview

Feed analytics give you visibility into how external platforms are consuming your product feeds — how often, by whom, and with what success rate.

​
Endpoint

GET /api/v1/feeds/{platform}/analytics

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

​
Response

{
  "platform": "google",
  "period": {
    "from": "2026-02-17T00:00:00Z",
    "to": "2026-03-17T23:59:59Z"
  },
  "total_fetches": 2847,
  "unique_consumers": 3,
  "avg_frequency_hours": 6.2,
  "error_rate": 0.004,
  "last_fetch_at": "2026-03-17T11:45:00Z",
  "product_count_trend": [
    { "date": "2026-03-15", "count": 1420 },
    { "date": "2026-03-16", "count": 1428 },
    { "date": "2026-03-17", "count": 1432 }
  ]
}

​
Response Fields

FieldTypeDescription
total_fetchesintegerTotal feed downloads in the period
unique_consumersintegerNumber of distinct consumer IPs/agents
avg_frequency_hoursfloatAverage hours between fetches
error_ratefloatFraction of requests that returned errors (0–1)
last_fetch_atISO 8601Timestamp of the most recent fetch
product_count_trendarrayDaily product count snapshots

​
Query Parameters

ParameterDefaultDescription
days30Lookback window (max: 90)
from—Start date (ISO 8601)
to—End date (ISO 8601)

​
Data Retention

Analytics data is retained for 90 days. Use the days parameter or from/to range to query any window within the retention period.

​
All Platforms Summary

To get analytics for all platforms at once: 
curl "https://app.alana.shopping/api/v1/feeds/analytics" \
  -H "X-API-Key: sk_live_your_api_key"
Last modified on March 18, 2026