Skip to main content
Shopify Insights logo

Shopify Insights

Order and sales aggregates from your Shopify store for any date window, computed inside FlyMyAI and returned without customer data - the numbers a performance-marketing agent needs next to ad spend (revenue, AOV, refunds, top products). Connects with a custom-app token you create in the store admin; no Partner app, no OAuth.

What it can do​

MethodWhat it does
shopify_shop_infoStore name, domain, currency, timezone and plan - confirms the connection.
shopify_orders_summaryOrders, cancelled and refunded orders, gross sales, discounts, refunds, net sales, shipping, tax, total revenue, AOV, refund rate, breakdown by day / week / month, top products, return / financial / fulfillment status counts.
shopify_top_productsTop products by revenue and units for the window, plus top refunded products.
shopify_returns_summaryRefunded orders, refund amount, refund rate, return statuses and top refunded products, by period.

Customer names, e-mails and addresses are never requested from Shopify, so they cannot reach the model. A call scans up to 2400 orders; truncated: true means narrow the window.

How to get credentials​

  1. In the store admin open Settings → Apps and sales channels → Develop apps (allow custom app development if asked) → Create an app.
  2. Configure Admin API scopes: read_orders, read_products (add read_all_orders if you need orders older than 60 days - Shopify grants it on request).
  3. Install app, then API credentials → Admin API access token → Reveal token once (shpat_...).

Fields to fill in FlyMyAI​

FlyMyAI fieldWhere it comes from
SHOPIFY_SHOPYour *.myshopify.com subdomain, e.g. myshop
SHOPIFY_ADMIN_TOKENDevelop apps → your app → API credentials → Admin API access token

Troubleshooting​

  • HTTP 401 / 403 - the token was rejected or lacks read_orders / read_products; re-check the custom app's scopes and reinstall it.
  • Only the last 60 days of orders - add the read_all_orders scope.
  • truncated: true - the window has more than 2400 orders; split it.
  • Throttled - Shopify's GraphQL cost limit; the tool retries with backoff, narrow the window if it persists.
We love our partners - FlyMy.AI builds with the best. Thanks, Shopify Insights!