Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Bem-vindo ao nosso novo hub de docs! Central de Ajuda + Docs para Desenvolvedores em um só lugar.
Track feed consumption metrics — fetches, unique consumers, error rates, and frequency.
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"
const res = await fetch(
"https://app.alana.shopping/api/v1/feeds/google/analytics",
{ headers: { "X-API-Key": "sk_live_your_api_key" } }
);
const analytics = await res.json();
console.log(analytics.total_fetches, analytics.unique_consumers);
import requests
res = requests.get(
"https://app.alana.shopping/api/v1/feeds/google/analytics",
headers={"X-API-Key": "sk_live_your_api_key"},
)
analytics = res.json()
print(analytics["total_fetches"], analytics["unique_consumers"])
{
"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 }
]
}
| Field | Type | Description |
|---|---|---|
total_fetches | integer | Total feed downloads in the period |
unique_consumers | integer | Number of distinct consumer IPs/agents |
avg_frequency_hours | float | Average hours between fetches |
error_rate | float | Fraction of requests that returned errors (0–1) |
last_fetch_at | ISO 8601 | Timestamp of the most recent fetch |
product_count_trend | array | Daily product count snapshots |
| Parameter | Default | Description |
|---|---|---|
days | 30 | Lookback window (max: 90) |
from | — | Start date (ISO 8601) |
to | — | End date (ISO 8601) |
days parameter or from/to range to query any window within the retention period.
curl "https://app.alana.shopping/api/v1/feeds/analytics" \
-H "X-API-Key: sk_live_your_api_key"
const res = await fetch(
"https://app.alana.shopping/api/v1/feeds/analytics",
{ headers: { "X-API-Key": "sk_live_your_api_key" } }
);
const summary = await res.json();
// Returns array of analytics per platform
import requests
res = requests.get(
"https://app.alana.shopping/api/v1/feeds/analytics",
headers={"X-API-Key": "sk_live_your_api_key"},
)
summary = res.json()
for platform in summary["platforms"]:
print(platform["platform"], platform["total_fetches"])