Metorik Docs

Reports

Products bought together

Returns product pairs that were purchased together in the selected period.
Use product_id to limit the response to pairs involving a specific product.

GET /api/v1/store/reports/products-bought-together

Products bought together

curl --request GET \
  --url 'https://{baseUrl}/api/v1/store/reports/products-bought-together' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "data": [
    {
      "times_bought_together": 18,
      "product_1": {
        "product_id": 4821,
        "variation_id": 0,
        "title": "Metorik Hoodie",
        "sku": "MTK-HOODIE"
      },
      "product_2": {
        "product_id": 5199,
        "variation_id": 0,
        "title": "Metorik Cap",
        "sku": "MTK-CAP"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "has_more_pages": true
  }
}

No response description.

Authorizations

  • Authorization string required header

    Generate a store API key from the store's Metorik API settings in Metorik, and choose the scopes needed for the endpoints you want to call.

Query Parameters

  • end_date string required

    End date in the store timezone using YYYY-MM-DD format. Example: 2026-02-28

  • order_filters string

    Optional JSON-encoded array of order-level filters applied before calculating the report. See Order Filters Reference. Example: [{"field":"billing_address_country","operator":"eq","value":"US"}]

  • page integer

    Page number for pagination. Example: 1

  • per_page integer

    Number of pairs per page. Min 1, max 100. Example: 10

  • product_id integer

    Limit results to pairs involving this product. Example: 4821

  • start_date string required

    Start date in the store timezone using YYYY-MM-DD format. Example: 2026-02-01

  • variation_id integer

    Limit results to pairs involving this variation. Requires product_id. Example: 9912

Headers

  • Accept string required

    Response format header. Example: application/json

Response

application/json
  • data[] object array
    + Show Child Attributes
    • times_bought_together integer
    • product_1 object
      + Show Child Attributes
      • product_id integer
      • variation_id integer
      • title string
      • sku string
    • product_2 object
      + Show Child Attributes
      • product_id integer
      • variation_id integer
      • title string
      • sku string
  • pagination object
    + Show Child Attributes
    • current_page integer
    • per_page integer
    • has_more_pages boolean