# E-commerce Analytics AI Assistant (`easyapi/ecommerce-analytics-ai-assistant`) Actor

🤖 Transform your business data into actionable insights! Get comprehensive e-commerce analysis with AI-powered recommendations, delivered in multiple formats (HTML, PDF, Markdown). Perfect for entrepreneurs, marketers, and business analysts seeking data-driven growth strategies.

- **URL**: https://apify.com/easyapi/ecommerce-analytics-ai-assistant.md
- **Developed by:** [EasyApi](https://apify.com/easyapi) (community)
- **Categories:** Agents, AI, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## E-commerce Analytics AI Assistant 📊

Transform your business data into actionable insights with our AI-powered e-commerce analytics assistant! This powerful tool analyzes your business metrics and generates comprehensive reports with targeted strategies for improvement.

Two versions for choice:
| **Pay Model**                                                                        | **Pricing**             |  
|--------------------------------------------------------------------------------------|-------------------------|
| [**Rental**](https://apify.com/easyapi/e-commerce-analytics-ai-assistant-rental)     | $29.99/month(no limit)  | 
| [**Pay-per-event**](https://apify.com/easyapi/e-commerce-analytics-ai-assistant)     | $4.99/event             |   


### 🌟 Key Features

- 🤖 AI-powered analysis of your business metrics and KPIs
- 📊 Detailed performance comparison tables
- 🎯 Actionable recommendations for improvement
- 📑 Multi-format report delivery (HTML, PDF, Markdown)
- 📈 Customized strategies based on your specific business context
- 🔄 Easy-to-understand metrics comparison
- 💡 ROI-focused improvement suggestions

### 🎯 Perfect For

- 📱 E-commerce business owners
- 📊 Marketing analysts
- 💼 Business consultants
- 🎯 Digital marketers
- 📈 Growth strategists

### 💪 Benefits

- Get instant, AI-powered business analysis
- Receive actionable insights tailored to your business
- Compare current vs target performance metrics
- Access reports in multiple formats for easy sharing
- Identify key areas for improvement
- Develop data-driven growth strategies

### 📝 Input Requirements

Simply provide basic information about your business:
- Product/service description
- Target market details
- Sales channels
- Key competitors
- Current biggest challenge

### 📊 Output

The actor generates comprehensive reports in three formats:
1. **HTML Report**: Clean, web-friendly format with styled tables and lists
2. **PDF Report**: Professional document perfect for sharing and printing
3. **Markdown Report**: Easy-to-edit format for further customization

Each report includes:
- Performance metrics analysis
- Current vs. target performance comparison
- Actionable improvement strategies
- Competitive insights
- Prioritized recommendations


#### Input Example
  
A full explanation of an input example in JSON.  
```json
 {
    "productService": "Apify is the largest ecosystem where developers build, deploy, and publish web scrapers, AI agents, and automation tools. We call them Actors.",
    "targetMarket": "Entrepreneurs, small business owners, content creators, marketers, solopreneurs.",
    "salesChannels": "Website, Social Media",
    "keyCompetitors": "Scrapfly, ScraperAPI, Enrich.so",
    "biggestChallenge": "Low conversion rate"
}
````

#### Output sample

The results will be wrapped into a dataset which you can always find in the **Storage** tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

```json
{
	"input": {
		"productService": "Apify is the largest ecosystem where developers build, deploy, and publish web scrapers, AI agents, and automation tools. We call them Actors.",
		"targetMarket": "Entrepreneurs, small business owners, content creators, marketers, solopreneurs.",
		"salesChannels": "Website, Social Media",
		"keyCompetitors": "Scrapfly, ScraperAPI, Enrich.so",
		"biggestChallenge": "Low conversion rate"
	},
	"htmlFile": "https://api.apify.com/v2/key-value-stores/null/records/analysis-report-2025-04-02T03-27-50-676Z.html",
	"pdfFile": "https://api.apify.com/v2/key-value-stores/null/records/analysis-report-2025-04-02T03-27-50-676Z.pdf",
	"markdownFile": "https://api.apify.com/v2/key-value-stores/null/records/analysis-report-2025-04-02T03-27-50-676Z.md"
}
```

##### Example screenshoot

![Example](https://i.imgur.com/oRQp0H8.png)

### 💡 Related Actors

Here are some other useful actors that complement your business analysis:

- 🔍 [Keyword Discovery Tool](https://apify.com/easyapi/keyword-discovery-tool) - Discover valuable search insights for your content strategy
- 📊 [Google RealTime Trends Data Scraper](https://apify.com/easyapi/google-realtime-trends-data-scraper) - Monitor trending search keywords across 40+ countries
- 🤖 [AI-powered Search](https://apify.com/easyapi/ai-powered-search) - Get AI-enhanced search summaries with optimization tips
- 💡 [AI Idea Generator](https://apify.com/easyapi/ai-idea-generator) - Generate innovative solutions for products and content
- 🎯 [Social Media Hashtag Generator](https://apify.com/easyapi/social-media-hashtag-generator) - Boost your social media strategy with targeted hashtags
- 📈 [Keyword Suggestions Scraper](https://apify.com/easyapi/keyword-suggestions-scraper) - Extract suggestions from multiple platforms
- 🔍 [Keyword Density Checker](https://apify.com/easyapi/keyword-density-checker) - Analyze webpage content for SEO optimization
- 🌐 [Article Content Extractor](https://apify.com/easyapi/article-content-extractor) - Extract clean article content and metadata
- 📊 [Text Sentiment Analysis](https://apify.com/easyapi/text-sentiment-analysis) - Analyze text sentiment for better insights
- 🎯 [Ranked Keywords Scraper](https://apify.com/easyapi/ranked-keywords-scraper) - Discover new keyword opportunities
- 🔍 [Google News Scraper](https://apify.com/easyapi/google-news-scraper) - Collect news articles for market research
- 📱 [Social Media Influencer Scraper](https://apify.com/easyapi/social-media-influencer-scraper) - Discover top influencers across platforms
- 🎯 [URL Metadata Crawler](https://apify.com/easyapi/url-metadata-crawler) - Extract comprehensive metadata from web pages
- 📊 [Meta Tags Check API](https://apify.com/easyapi/meta-tags-check-api) - Optimize your website's meta tags
- 🤖 [Text Summarization](https://apify.com/easyapi/text-summarization) - Generate concise summaries of documents

# Actor input Schema

## `productService` (type: `string`):

Detailed description of your product or service

## `targetMarket` (type: `string`):

Description of your target market/audience

## `salesChannels` (type: `string`):

List your primary sales channels

## `keyCompetitors` (type: `string`):

List your main competitors

## `biggestChallenge` (type: `string`):

Your current biggest business challenge

## Actor input object example

```json
{
  "productService": "Apify is the largest ecosystem where developers build, deploy, and publish web scrapers, AI agents, and automation tools. We call them Actors.",
  "targetMarket": "Entrepreneurs, small business owners, content creators, marketers, solopreneurs.",
  "salesChannels": "Website, Social Media",
  "keyCompetitors": "Scrapfly, ScraperAPI, Enrich.so",
  "biggestChallenge": "Low conversion rate"
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("easyapi/ecommerce-analytics-ai-assistant").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("easyapi/ecommerce-analytics-ai-assistant").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call easyapi/ecommerce-analytics-ai-assistant --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=easyapi/ecommerce-analytics-ai-assistant",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "E-commerce Analytics AI Assistant",
        "description": "🤖 Transform your business data into actionable insights! Get comprehensive e-commerce analysis with AI-powered recommendations, delivered in multiple formats (HTML, PDF, Markdown). Perfect for entrepreneurs, marketers, and business analysts seeking data-driven growth strategies.",
        "version": "0.0",
        "x-build-id": "FZmEEMKciQjNQWRqU"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/easyapi~ecommerce-analytics-ai-assistant/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-easyapi-ecommerce-analytics-ai-assistant",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/easyapi~ecommerce-analytics-ai-assistant/runs": {
            "post": {
                "operationId": "runs-sync-easyapi-ecommerce-analytics-ai-assistant",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/easyapi~ecommerce-analytics-ai-assistant/run-sync": {
            "post": {
                "operationId": "run-sync-easyapi-ecommerce-analytics-ai-assistant",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "productService",
                    "targetMarket",
                    "salesChannels",
                    "keyCompetitors",
                    "biggestChallenge"
                ],
                "properties": {
                    "productService": {
                        "title": "Product/Service Description",
                        "type": "string",
                        "description": "Detailed description of your product or service",
                        "default": "Apify is the largest ecosystem where developers build, deploy, and publish web scrapers, AI agents, and automation tools. We call them Actors."
                    },
                    "targetMarket": {
                        "title": "Target Market",
                        "type": "string",
                        "description": "Description of your target market/audience",
                        "default": "Entrepreneurs, small business owners, content creators, marketers, solopreneurs."
                    },
                    "salesChannels": {
                        "title": "Sales Channels",
                        "type": "string",
                        "description": "List your primary sales channels",
                        "default": "Website, Social Media"
                    },
                    "keyCompetitors": {
                        "title": "Key Competitors",
                        "type": "string",
                        "description": "List your main competitors",
                        "default": "Scrapfly, ScraperAPI, Enrich.so"
                    },
                    "biggestChallenge": {
                        "title": "Biggest Challenge",
                        "type": "string",
                        "description": "Your current biggest business challenge",
                        "default": "Low conversion rate"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```