WooCommerce REST API Endpoints for Reports | Documentation

Share on facebook
Share on twitter
Share on linkedin
Share on reddit
Share on email

Master WooCommerce Reports API for comprehensive e-commerce analytics. Track sales, top sellers, and more for strategic growth.

WooCommerce Reports API: Harnessing Data for E-Commerce Insights

The WooCommerce Reports API is a robust tool that empowers businesses to extract meaningful data and analytics from their e-commerce platforms. This guide provides a structured overview of the API endpoints, offering insights into each report’s capabilities and usage.

API Endpoint Overview

  1. Listing All Reports
  • Endpoint : `GET /wp-json/wc/v3/reports`
  • Description : Fetches a list of all available reports, providing a snapshot of the store’s diverse data points.
  1. Sales Report
  • Endpoint : `GET /wp-json/wc/v3/reports/sales`
  • Properties :
  • Total Sales: Gross sales within a specified period.
  • Net Sales: Sales net of returns and discounts.
  • Average Sales : Daily average of net sales.
  • Total Orders : The count of all orders placed.
  • Total Items : The number of items sold.
  • Total Tax : The cumulative tax charged.
  • Total Shipping : Total shipping fees accrued.
  • Total Refunds : The sum of refunds processed.
  • Total Discount : The total value of discounts applied.
  • Parameters : Allows filtering by context, period, and specific dates.
  1. Top Sellers Report
  • Endpoint : `GET /wp-json/wc/v3/reports/top_sellers`
  • Description : Identifies the best-selling products, aiding in inventory and marketing decisions.
  1. Coupons Totals
  • Endpoint : `GET /wp-json/wc/v3/reports/coupons/totals`
  • Description : Offers insights into coupon usage, helping to evaluate promotional strategies.
  1. Customers Totals
  • Endpoint : `GET /wp-json/wc/v3/reports/customers/totals`
  • Description : Tracks customer growth and engagement over time.
  1. Orders Totals
  • Endpoint : `GET /wp-json/wc/v3/reports/orders/totals`
  • Description : Provides a summary of order volumes and trends.
  1. Products Totals
  • Endpoint : `GET /wp-json/wc/v3/reports/products/totals`
  • Description : Assesses product performance and popularity.
  1. Reviews Totals
  • Endpoint : `GET /wp-json/wc/v3/reports/reviews/totals`
  • Description : Gauges customer feedback and product reception.

Advanced Data Retrieval with WooCommerce Reports API

  1. Customizing Data Queries
  • Endpoint Customization : Tailor API requests to retrieve specific data sets.
  • Example: To fetch sales data for a particular category, modify the `GET /wp-json/wc/v3/reports/sales` endpoint with additional parameters like `filter[category]=coffee`.
  1. Real-Time Data Access
  • Real-Time Reporting : Use the API to access up-to-date information.
  • Example: Implement a dashboard that uses `GET /wp-json/wc/v3/reports` to display real-time sales and inventory levels.
  1. Integrating External Data Sources
  • Data Enrichment : Combine external data sources with WooCommerce data for comprehensive analytics.
  • Example: Merge customer demographic data from a CRM with the `GET /wp-json/wc/v3/reports/customers/totals` endpoint to segment customers more effectively.

Enhancing E-Commerce Strategy with API Insights

  • Sales Forecasting
  • Predictive Analytics : Leverage historical sales data to forecast future trends.
  • Example: Analyze past sales reports to predict upcoming seasonal demand, adjusting stock levels accordingly.
  • Marketing Campaign Analysis
  • ROI Tracking : Assess the effectiveness of marketing campaigns.
  • Example: Use the `GET /wp-json/wc/v3/reports/coupons/totals` endpoint to track coupon redemption rates and calculate campaign ROI.
  • Product Performance Review
  • Product Analytics : Evaluate product sales performance to inform inventory decisions.
  • Example: Identify top sellers with `GET/wp-json/wc/v3/reports/top_sellers` and adjust marketing focus to boost underperforming products.

Streamlining Operations with Automated Reporting

  1. Automated Report Generation
  • Scheduled Reports : Set up automated reporting for regular intervals.
  • Example: Configure a cron job to call `GET /wp-json/wc/v3/reports/sales` daily, compiling sales data for analysis.
  1. Custom Report Creation
  • Tailored Reports : Create custom reports based on specific business needs.
  • Example: Develop a custom report that combines sales, customers, and inventory data to provide a holistic view of business health.
  1. API-Driven Decision Making
  • Data-Driven Strategies : Use API data to make informed business decisions.
  • Example: Analyze the `GET /wp-json/wc/v3/reports/products/totals` report to decide which products to discontinue or promote.

The WooCommerce Reports API is a powerful tool for accessing and analyzing your e-commerce data. By understanding and utilizing the various endpoints and parameters, you can gain valuable insights that drive strategic business decisions. Whether you’re looking to enhance your marketing efforts, streamline operations, or simply understand your sales trends better, the WooCommerce Reports API provides the data you need to succeed.

Leveraging the API for Business Growth

The WooCommerce Reports API is invaluable for merchants seeking to understand their store’s performance and customer behavior. By integrating this API, businesses can:

  • Automate Reporting : Schedule regular data retrieval for up-to-date insights.
  • Customize Analytics : Tailor reports to focus on metrics that matter most.
  • Drive Decisions : Use data-driven insights to inform strategy and operations.


The WooCommerce Reports API is a gateway to unlocking the full potential of your e-commerce data. Whether you’re a developer or a business owner, harnessing this API can lead to more informed decisions and a clearer path to success.


1. How can I access the WooCommerce Reports API?

Utilize the `GET` request method with the appropriate endpoint to retrieve data.

2. What kind of data can I get from the WooCommerce Reports API?

Access detailed information on sales, customers, products, and more.

3. Do I need technical expertise to use the WooCommerce Reports API?

While some technical knowledge is helpful, non-developers can leverage tools like InfoCaptor’s Advanced WooCommerce Reporting to simplify the process.

4. How can I ensure my API queries are secure?

Utilize HTTPS for API requests and manage API keys securely to protect your data.

5. Can I access historical data through the WooCommerce Reports API?

Yes, use the `date_min` and `date_max` parameters to retrieve data from specific time periods.

6. What if I need a report that isn’t available by default?

You can extend the API using custom endpoints or combine existing endpoints to create new reports tailored to your requirements.

The Core Tools

Create dashboard for any Database

Data Visualizer and Dashboard Application
This is the best dashboard software for its price. One good thing we did was to hire their consulting services to build few dashboard prototypes and provide some quick dashboard training.
- Terry Seal, IL
We evaluated Xcelsius and Qlikview and the cost for organization to implement dashboards was quoted over 10,000 USD. For fraction of the above quoted price, we were able to buy the licenses for the web based dashboard software and get some free training. This is truly a dashboard software for small businesses like us.
IT Manager of a Trucking company, OH