Metrics

iFood Analytics metrics via API

Your customer connects their iFood Analytics account and your product queries 55 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "ifood_analytics:gmv",
      "component": "number_v1",
      "metrics": [
        "gmv"
      ]
    }
  ]
}
Example: "GMV" in October, compared to September.

More iFood Analytics request examples

The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).

Chart

Orders by sales channel

Concluded orders by sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "ifood_analytics:orders_by_sales_channel",
      "component": "chart_v1",
      "metrics": [
        "concluded_orders"
      ],
      "dimensions": [
        "sales_channel"
      ]
    }
  ]
}

Table

Cancellations by reason

Canceled orders by the reason given for the cancellation. iFood publishes this data on the following day, and the last 15 days may still change.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "ifood_analytics:cancellations_by_reason",
      "component": "datatable_v1",
      "metrics": [
        "cancelled_orders"
      ],
      "dimensions": [
        "cancellation_reason"
      ]
    }
  ]
}

Number

GMV without delivery

GMV of the concluded orders without the delivery fee paid by the customer. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "ifood_analytics:gmv_without_delivery",
      "component": "number_v1",
      "metrics": [
        "gmv_without_delivery"
      ]
    }
  ]
}

Numbers

36 metrics

  • GMV

    Value of the concluded orders in the analyzed period: items plus delivery fee, after the service fee and the subsidies funded by the store. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:gmv
  • GMV without delivery

    GMV of the concluded orders without the delivery fee paid by the customer. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:gmv_without_delivery
  • Average ticket

    GMV divided by the number of concluded orders in the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:average_ticket
  • Concluded orders

    Orders concluded in the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:concluded_orders
  • Canceled orders

    Orders canceled in the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:cancelled_orders
  • Cancellation rate

    Share of canceled orders among all the orders in the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:cancellation_rate
  • Total orders

    Concluded and canceled orders in the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders
  • New customers

    Concluded orders placed by customers ordering from the store for the first time. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:new_customers
  • Returning customers

    Concluded orders placed by customers who had already ordered from the store. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:returning_customers
  • New customers rate

    Share of the concluded orders placed by first-time customers. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:new_customers_rate
  • Orders with iFood Hits

    Concluded orders that used the iFood Hits promotional benefit. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_with_hits
  • Delivery fee

    Delivery fees paid by customers in the concluded orders, after any shipping discount. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:net_delivery_fee
  • Total paid

    Amount actually paid by customers in the concluded orders, across every payment method. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:payment_total_value
  • Gross value

    Items, service fees and delivery fees of the concluded orders before discounts. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:payment_gross_value
  • Service fees paid by customers

    Service fees charged to customers in the concluded orders, after discounts. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:fees_customer_net_value
  • Gross service fees

    Service fees charged to customers in the concluded orders, before discounts. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:fees_customer_gross_value
  • Service fees charged to the store

    Service fees charged to the store in the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:fees_gross_value
  • Partner subsidies

    Subsidies funded by partners in the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:benefit_by_type_partner_total_value
  • Freight charged to the store

    Amount iFood charged the store for iFood Logistics in the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:freight_charged_from_merchant
  • Refunded value

    Amount refunded to customers because of cancellations in the analyzed period. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:refunded_total_value
  • Average distance

    Average straight-line distance in km between the store and the customer in the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:distance_km
  • Average route distance

    Average distance in km of the delivery route from the store to the customer in the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:route_to_destination_distance_in_km
  • Complementary routes

    Complementary delivery routes of the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:complement_delivery
  • Preparation time

    Average time the store took to prepare the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:preparation_time
  • Preparation time at assignment

    Average effective preparation time of the concluded orders when the courier was assigned. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:effective_preparation_time_at_assign
  • Planned preparation time

    Average preparation time set when the delivery of the concluded orders was created. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:original_preparation_time
  • Time to ready

    Average time between the order creation and the store marking it as ready. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:ready_for_delivery_time
  • Time to accept

    Average time for the courier to accept the delivery of the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:time_to_accept
  • Time to assign

    Average time between the order creation and the courier assignment. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:time_to_assign
  • Time to the store

    Average time the courier took to reach the store after accepting the route. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:time_to_origin
  • Time at the store

    Average time the courier waited at the store on the last assigned route. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:time_at_origin
  • Time at the store, all routes

    Average time couriers waited at the store across every route, including the unassigned ones. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:time_at_origin_global
  • Time to the customer

    Average time the courier took from the store to the customer in the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:time_to_destination
  • Delivery time

    Average total delivery time of the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:delivery_time
  • Expected delivery time

    Average delivery time iFood estimated for the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:expected_delivery_time
  • Delivery delay

    Average difference between the actual and the expected delivery time of the concluded orders. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:delivery_delay

Charts

15 metrics

  • Orders by sales channel

    Concluded orders by sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_sales_channel
  • Orders by status

    Orders by status, concluded or canceled, in the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_status
  • Orders by payment method

    Concluded orders by payment method. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_payment_method
  • Orders by delivery model

    Concluded orders by delivery model: iFood delivery, store delivery or dine in. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_delivery_model
  • Orders by day of the week

    Concluded orders on each day of the week. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_day_of_week
  • Orders by hour

    Concluded orders by the hour they were placed. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_hour
  • Orders by category

    Concluded orders by business category, such as food or grocery. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_category
  • Orders by customer type

    Concluded orders split between new and returning customers. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_customer_type
  • Orders by iFood Hits

    Concluded orders split between the ones that used the iFood Hits promotional benefit and the ones that did not. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_by_hits
  • GMV over time

    GMV of the concluded orders on each day of the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:gmv_over_time
  • Orders over time

    Concluded orders on each day of the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:orders_over_time
  • Canceled orders over time

    Orders canceled on each day of the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:cancelled_orders_over_time
  • Average ticket over time

    Average ticket of the concluded orders on each day of the analyzed period. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:average_ticket_over_time
  • Cancellations by origin

    Canceled orders by who canceled them: the store, the customer, iFood, its logistics or a partner. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:cancellations_by_origin
  • Cancellations by stage

    Canceled orders by the stage the order was in when it was canceled. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:cancellations_by_stage

Tables

4 metrics

  • Cancellations by reason

    Canceled orders by the reason given for the cancellation. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:cancellations_by_reason
  • GMV by payment method

    Concluded orders and their GMV by payment method. Includes every sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:gmv_by_payment_method
  • GMV by sales channel

    Concluded orders and their GMV by sales channel (iFood app, digital menu, POS and partner apps). iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:gmv_by_sales_channel
  • GMV by delivery model

    Concluded orders and their GMV by delivery model: iFood delivery, store delivery or dine in. iFood publishes this data on the following day, and the last 15 days may still change.

    ifood_analytics:gmv_by_delivery_model

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.