The Total Sales report provides total sales performance by product and category for sponsored items campaigns.

¶ Report Details

Report Type ID: gr_total_sales

Use Cases:

• Product sales performance analysis
• Category performance insights
• Inventory and demand planning

Dimensions:

• gtin: Global Trade Item Number
• product_name: Product name
• sales_channel: Distribution channel
• l1_category_name, l2_category_name, l3_category_name, l4_category_name: Product category hierarchy
• brand: Brand name
• product_unit: Product unit measurement

¶ Available Metrics

• units
• total_orders
• total_sales_usd
• total_sales_local

¶ Example Request

curl -X POST "https://api.uber.com/v1/ads/{account_id}/reporting/report" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Accept: application/json" \
  -d '{
    "report_type": "GR_TOTAL_SALES",
    "time_range": {
      "start_time": "2025-07-01T00:00:00Z",
      "end_time": "2025-08-01T00:00:00Z"
    },
    "columns": [
      "gtin",
      "product_name",
      "sales_channel",
      "l1_category_name",
      "l2_category_name",
      "brand",
      "units",
      "total_orders",
      "total_sales_usd"
    ],
    "time_unit": "MONTHLY",
    "file_format": "CSV",
    "filters": [
      {
        "column": "brand",
        "operator": "EQUAL",
        "values": ["Fresh Valley"]
      }
    ]
  }'

¶ Example Response

{
  "report_id": "8a2e38b2-59fb-5242-a0ec-e913a42150b5"
}

¶ Related Reports

• Category Share by Brand - Brand market share analysis
• Category Share by Brand Owner - Brand owner market share analysis