Skip to main content

​
get_search_analytics

Retrieve aggregated search analytics for your catalog. Parameters:
ParameterTypeRequiredDescription
daysintegerNoLookback window in days (default: 30, max: 90)
catalog_idstringNoFilter to a specific catalog
curl -X POST "https://app.alana.shopping/api/mcp/sse" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"method":"tools/call","params":{"name":"get_search_analytics","arguments":{"days":30}}}'
Response: 
{
  "period_days": 30,
  "total_queries": 18420,
  "zero_result_rate": 0.032,
  "avg_results_per_query": 12.4,
  "top_queries": [
    { "query": "cotton t-shirt", "count": 842 },
    { "query": "running shoes", "count": 671 }
  ]
}

​
get_query_performance

Get performance metrics for specific search queries. Parameters:
ParameterTypeRequiredDescription
queriesstring[]YesQueries to analyze (max: 20)
daysintegerNoLookback window (default: 30)
const result = await client.callTool({
  name: "get_query_performance",
  arguments: {
    queries: ["cotton t-shirt", "running shoes"],
    days: 30,
  },
});
Response: 
{
  "queries": [
    {
      "query": "cotton t-shirt",
      "count": 842,
      "avg_results": 18,
      "click_through_rate": 0.41,
      "zero_results": false
    }
  ]
}

​
get_recommendation_stats

Retrieve statistics on product recommendations and their effectiveness. Parameters:
ParameterTypeRequiredDescription
daysintegerNoLookback window (default: 30)
product_idstringNoFilter to recommendations for a specific product
const result = await client.callTool({
  name: "get_recommendation_stats",
  arguments: { days: 30 },
});
Response: 
{
  "period_days": 30,
  "total_recommendations_shown": 94200,
  "click_through_rate": 0.087,
  "conversion_rate": 0.012,
  "top_recommended_products": [
    { "product_id": "SKU-001", "impressions": 4820, "clicks": 389 }
  ]
}
Last modified on March 18, 2026