Sales API

Access your Shopify sales data and analytics.

Get Sales Analytics

Returns a summary of sales metrics for the specified period.

GET /api/v1/sales/analytics

Parameters

Parameter	Type	Required	Description
period	string	No	Time period (default: today)

Example Request

curl -H "Authorization: Bearer ned_live_YOUR_KEY" \
  "https://api.meetned.com/api/v1/sales/analytics?period=last_7_days"

Example Response

{
  "data": {
    "summary": {
      "total_revenue": 12450.00,
      "total_orders": 89,
      "average_order_value": 139.89,
      "units_sold": 156
    },
    "comparison": {
      "revenue_change": 12.5,
      "orders_change": 8.2,
      "aov_change": 3.9
    },
    "top_products": [
      {
        "product_id": "12345",
        "title": "Premium Widget",
        "revenue": 2340.00,
        "units": 18
      }
    ]
  },
  "meta": {
    "period": "last_7_days",
    "generated_at": "2025-02-04T12:00:00Z"
  }
}

---

Get Daily Sales

Returns a day-by-day breakdown of sales for the specified period.

GET /api/v1/sales/daily

Parameters

Parameter	Type	Required	Description
period	string	No	Time period (default: last_7_days)

Example Request

curl -H "Authorization: Bearer ned_live_YOUR_KEY" \
  "https://api.meetned.com/api/v1/sales/daily?period=last_7_days"

Example Response

{
  "data": {
    "days": [
      {
        "date": "2025-01-28",
        "revenue": 1820.00,
        "orders": 14,
        "aov": 130.00
      },
      {
        "date": "2025-01-29",
        "revenue": 2100.00,
        "orders": 16,
        "aov": 131.25
      }
    ]
  },
  "meta": {
    "period": "last_7_days",
    "generated_at": "2025-02-04T12:00:00Z"
  }
}

---

Get Sales Forecast

Returns historical sales data plus a 30-day revenue forecast.

Growth Tier Required

This endpoint requires a Growth subscription or higher.

GET /api/v1/sales/forecast

Parameters

Parameter	Type	Required	Description
period	string	No	Historical period (default: last_30_days)

Example Request

curl -H "Authorization: Bearer ned_live_YOUR_KEY" \
  "https://api.meetned.com/api/v1/sales/forecast"

Example Response

{
  "data": {
    "historical": [
      {
        "date": "2025-01-05",
        "revenue": 1650.00,
        "type": "actual"
      }
    ],
    "forecast": [
      {
        "date": "2025-02-05",
        "revenue": 1720.00,
        "confidence_low": 1550.00,
        "confidence_high": 1890.00,
        "type": "forecast"
      }
    ],
    "summary": {
      "projected_30_day_revenue": 52400.00,
      "confidence_interval": "85%"
    }
  },
  "meta": {
    "period": "last_30_days",
    "generated_at": "2025-02-04T12:00:00Z"
  }
}