aggregation_search

index.js

import algoliasearch from 'algoliasearch';
const client = algoliasearch('applicationId', 'apiKey');

const index = client.initIndex('indexName');

index.setSettings({
  attributesForFaceting: ['someDate']
  // other settings
});

index
  .search({
    query: 'query',
    aggregation: {
      type: 'date',
      field: 'someDate',
      interval: '1w'
      // we could image to have nested aggregations
      // for exemple making a timeline with the avg of price per color
      // with some nested parameters:
      // aggregation: {
      //   type: 'avg',
      //   field: 'price'
      //   facet: ['color']
      // }
    }
  })
  .then(res => {
    // The main data I would then need to get is sth like that
    res = {
      aggregation: [
        {
          facetValue: 'date1',
          hits: [
            /*matching objects */
          ]
        },
        {
          facetValue: 'date2',
          hits: [
            /*matching objects */
          ]
        },
        {
          facetValue: 'date3',
          hits: [
            /*matching objects */
          ]
        }
      ]
    };

    // or with nested aggregations
    // it's missing a lot of meta info but the main idea is here I hope :)
    res = {
      aggregation: [
        {
          facetValue: 'date1',
          aggregation: [
            {
              facetValue: 'color1',
              value: 'avgPrice',
              hits: [
                /*matching objects*/
              ]
            }
          ]
        },
        {
          facetValue: 'date2',

          aggregation: [
            {
              facetValue: 'color1',
              value: 'avgPrice',
              hits: [
                /*matching objects*/
              ]
            }
          ]
        },
        {
          facetValue: 'date3',

          aggregation: [
            {
              facetValue: 'color1',
              value: 'avgPrice',
              hits: [
                /*matching objects*/
              ]
            }
          ]
        }
      ]
    };
  });

We would also need the different facet values for color somewhere :)