Analytics & Reporting - eBay MCP Server

The eBay MCP Server provides analytics and reporting capabilities through the Analytics API, offering 4 specialized tools to monitor listing traffic, seller performance standards, and customer service metrics.

Overview

eBay’s Analytics API helps you understand how your listings perform, track your seller standards compliance, and monitor customer service quality. These insights enable data-driven decisions to improve sales and maintain good seller standing.

Analytics Coverage:

Traffic Reports: Listing views, clicks, conversion rates
Seller Standards: Performance evaluation and compliance
Customer Service Metrics: Response times and satisfaction

Core Capabilities

Traffic Reports

Track listing impressions, clicks, and sales

Seller Standards

Monitor performance evaluation scores

Customer Service

Measure response times and quality

Historical Data

Access performance trends over time

Traffic Reports

Monitor how buyers discover and interact with your listings across eBay.

Understanding Traffic Metrics

Key Metrics
Dimensions

IMPRESSION: Number of times listing appeared in search
CLICK_THROUGH_RATE: Percentage of impressions that resulted in clicks
LISTING_VIEWS: Number of times listing page was viewed
SALES_CONVERSION_RATE: Percentage of views that resulted in sales
TRANSACTION: Number of completed sales

Generating Traffic Reports

Request Traffic Report

{
  "dimension": "LISTING",
  "filter": "listingIds:{123456789012|123456789013}",
  "metric": "CLICK_THROUGH_RATE,IMPRESSION,LISTING_VIEWS,SALES_CONVERSION_RATE",
  "sort": "-LISTING_VIEWS"
}

Parameters:

dimension - How to group data (LISTING, DAY, etc.)
filter - Which listings/dates to include
metric - Which metrics to retrieve
sort - Sort order (prefix with - for descending)

Tool: ebay_get_traffic_report

Analyze Report Data

Typical Response:

{
  "records": [
    {
      "dimension": {
        "dimensionKey": "LISTING",
        "dimensionValues": [
          {
            "name": "listingId",
            "value": "123456789012"
          }
        ]
      },
      "metrics": [
        {
          "name": "IMPRESSION",
          "value": "1250"
        },
        {
          "name": "CLICK_THROUGH_RATE",
          "value": "3.2"
        },
        {
          "name": "LISTING_VIEWS",
          "value": "40"
        },
        {
          "name": "SALES_CONVERSION_RATE",
          "value": "12.5"
        },
        {
          "name": "TRANSACTION",
          "value": "5"
        }
      ]
    }
  ]
}

Common Traffic Report Scenarios

Top Performing Listings

Identify your best sellers:

{
  "dimension": "LISTING",
  "filter": "lastAccessDate:[2025-01-01T00:00:00.000Z..2025-01-31T23:59:59.999Z]",
  "metric": "TRANSACTION,SALES_CONVERSION_RATE,LISTING_VIEWS",
  "sort": "-TRANSACTION"
}

Analysis: Look for listings with high transaction counts and conversion rates to identify successful products.

Traffic Trends Over Time

Track daily performance:

{
  "dimension": "DAY",
  "filter": "listingIds:{123456789012}",
  "metric": "IMPRESSION,LISTING_VIEWS,TRANSACTION",
  "sort": "DAY"
}

Analysis: Identify traffic patterns, seasonal trends, and campaign impact.

Low Conversion Listings

Find underperforming listings:

{
  "dimension": "LISTING",
  "filter": "lastAccessDate:[2025-01-01T00:00:00.000Z..2025-01-31T23:59:59.999Z]",
  "metric": "LISTING_VIEWS,SALES_CONVERSION_RATE",
  "sort": "SALES_CONVERSION_RATE"
}

Analysis: Listings with many views but low conversion may need better photos, descriptions, or pricing.

Click-Through Rate Analysis

Optimize search visibility:

{
  "dimension": "LISTING",
  "filter": "lastAccessDate:[2025-01-01T00:00:00.000Z..2025-01-31T23:59:59.999Z]",
  "metric": "IMPRESSION,CLICK_THROUGH_RATE",
  "sort": "CLICK_THROUGH_RATE"
}

Analysis: Low CTR despite high impressions suggests title or thumbnail optimization needed.

Seller Standards Profiles

Monitor your seller performance evaluation and compliance with eBay’s seller standards.

Understanding Seller Standards

eBay evaluates sellers based on:

Defect Rate: Late shipments, canceled orders, returns
Customer Satisfaction: Positive feedback, detailed ratings
Shipping Performance: On-time delivery rates
Case Closure Rate: How disputes are resolved

Important: Maintaining good seller standards is critical. Below Standard status can result in search placement降低, increased fees, or account suspension.

Checking Seller Standards

Get All Standards Profiles

{}  // No parameters required

Tool: ebay_find_seller_standards_profilesReturns: All evaluation cycles and programs

Get Specific Profile

{
  "program": "CUSTOMER_SERVICE",
  "cycle": "CURRENT"
}

Programs:

CUSTOMER_SERVICE - Overall seller performance
SELLER_LEVEL_PLUS - Top-rated seller program

Cycles:

CURRENT - Current evaluation period
PREVIOUS - Last completed evaluation
PROJECTED - Forecasted next evaluation

Tool: ebay_get_seller_standards_profile

Interpreting Standards Data

Standard Performance Levels

Above Standard:

Exceeds performance requirements
Eligible for search benefits and lower fees
May qualify for Top Rated Seller status

Standard:

Meets performance requirements
Good standing with no penalties

Below Standard:

Does not meet requirements
May face search placement降低
Higher fees may apply
Risk of account restrictions

Action Required:

Immediate intervention needed
Significant performance issues
Account at risk of suspension

Example Response

{
  "program": "CUSTOMER_SERVICE",
  "cycle": "CURRENT",
  "status": "ABOVE_STANDARD",
  "evaluationDate": "2025-02-01T00:00:00.000Z",
  "metrics": [
    {
      "name": "DEFECT_RATE",
      "value": "0.8",
      "benchmark": "2.0"
    },
    {
      "name": "LATE_SHIPMENT_RATE",
      "value": "1.2",
      "benchmark": "3.0"
    },
    {
      "name": "CASES_NOT_RESOLVED",
      "value": "5",
      "benchmark": "10"
    }
  ]
}

Customer Service Metrics

Track your customer service quality and response performance.

Available Metrics

Response Time

Average time to respond to buyer messages

Resolution Rate

Percentage of inquiries resolved satisfactorily

Message Volume

Number of customer service contacts

Satisfaction Score

Buyer ratings of support quality

Retrieving Customer Service Metrics

{
  "customerServiceMetricType": "RESPONSE_TIME",
  "evaluationType": "CURRENT",
  "evaluationMarketplaceId": "EBAY_US"
}

Metric Types:

RESPONSE_TIME - How quickly you respond
RESOLUTION_RATE - How effectively you resolve issues
INQUIRY_VOLUME - Number of customer contacts
SATISFACTION_SCORE - Overall customer satisfaction

Evaluation Types:

CURRENT - Current period
PREVIOUS - Last completed period
PROJECTED - Forecasted score

Tool: ebay_get_customer_service_metric

Best Practice: Aim to respond to all buyer messages within 24 hours. Fast response times improve customer satisfaction and seller standards scores.

Analytics Best Practices

Monitor Regularly

Check traffic reports weekly
Review seller standards monthly
Track customer service metrics daily

Act on Insights

Low CTR? Improve titles and thumbnailsHigh views, low sales? Review pricing and descriptionsBelow standard? Focus on shipping speed and communication

Compare Periods

Track performance over time:

Week over week growth
Month over month trends
Year over year comparison

Set Performance Goals

Target conversion rate improvements
Aim for Above Standard status
Reduce response time targets

Common Use Cases

Weekly Performance Review

Recommended workflow:

Get traffic report for past 7 days
Identify top and bottom performers
Check seller standards status
Review customer service metrics
Make data-driven adjustments

New Listing Analysis

First 30 days after listing:

Track daily impressions and views
Monitor conversion rates
Compare to similar listings
Optimize based on performance

Campaign Performance Tracking

During promotional campaigns:

Get baseline traffic before campaign
Monitor daily during campaign
Calculate ROI post-campaign
Identify most effective promotions

Seller Standards Improvement

If below standard:

Check current standards profile
Identify problem areas
Review customer service metrics
Implement corrective actions
Monitor projected status

Tool Reference

Traffic Reports (1 tool)

ebay_get_traffic_report - Retrieve listing traffic and performance data

Seller Standards (2 tools)

ebay_find_seller_standards_profiles - List all standards profiles
ebay_get_seller_standards_profile - Get specific profile details

Customer Service (1 tool)

ebay_get_customer_service_metric - Retrieve customer service metrics

Understanding the Data

When Data Updates

Traffic Reports: Updated daily (previous day’s data available by 8am PT)
Seller Standards: Evaluated monthly, typically on the 20th
Customer Service: Updated daily with rolling averages

Data Retention

Traffic Reports: 2 years of historical data
Seller Standards: Current and 12 previous evaluation cycles
Customer Service: 90 days of detailed metrics

Marketplace Differences

Different marketplaces may have:

Different seller standard thresholds
Different metric availability
Different update schedules

Always specify the correct marketplaceId in your requests.

Next Steps

Marketing Campaigns

Use insights to optimize campaigns

Best Practices Guide

Learn optimization strategies

Analytics API Reference

Complete API documentation

Account Management

Manage seller account settings

Rate Limits

User Tokens: 10,000-50,000 requests/dayRecommendation: Analytics data updates daily, so once-daily retrieval is typically sufficient

See Rate Limits for detailed information.

Getting Started

Authentication

Core Features

Guides

MCP Integration

Advanced

Support

​Overview

​Core Capabilities

Traffic Reports

Seller Standards

Customer Service

Historical Data

​Traffic Reports

​Understanding Traffic Metrics

​Generating Traffic Reports

​Common Traffic Report Scenarios

​Seller Standards Profiles

​Understanding Seller Standards

​Checking Seller Standards

​Interpreting Standards Data

​Customer Service Metrics

​Available Metrics

Response Time

Resolution Rate

Message Volume

Satisfaction Score

​Retrieving Customer Service Metrics

​Analytics Best Practices

​Common Use Cases

​Tool Reference

​Traffic Reports (1 tool)

​Seller Standards (2 tools)

​Customer Service (1 tool)

​Understanding the Data

​Next Steps

Marketing Campaigns

Best Practices Guide

Analytics API Reference

Account Management

​Rate Limits

Overview

Core Capabilities

Traffic Reports

Understanding Traffic Metrics

Generating Traffic Reports

Common Traffic Report Scenarios

Seller Standards Profiles

Understanding Seller Standards

Checking Seller Standards

Interpreting Standards Data

Customer Service Metrics

Available Metrics

Retrieving Customer Service Metrics

Analytics Best Practices

Common Use Cases

Tool Reference

Traffic Reports (1 tool)

Seller Standards (2 tools)

Customer Service (1 tool)

Understanding the Data

Next Steps

Rate Limits