Guides

Historical Summary

The historical endpoint provides summaries over six different time ranges

curl -X POST \
  https://api.fideo.ai/beta/signals/patterns/summary  \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
      "email" : "[email protected]"
  }'
{
    "hour": {
        "hits": 0,
        "sources": 0
    },
    "day": {
        "hits": 19,
        "sources": 4
    },
    "week": {
        "hits": 107,
        "sources": 6
    },
    "month": {
        "hits": 478,
        "sources": 19
    },
    "sixMonth": {
        "hits": 2167,
        "sources": 27
    },
    "year": {
        "hits": 2727,
        "sources": 39
    }
}

The only input, is a single email attribute. Note email hashes are not supported.


Values will be returned for each of the intervals below:

  • hour (last 60 minutes)
  • day (last 24 hours)
  • week (last 7 days)
  • month (last 30 days)
  • sixMonth (last 6 months)
  • year (last 12 months)

For each interval in the response, two counts will be returned:

  1. hits - the total number of times the particular email was seen in that pattern interval, across all sources
  2. sources - the count of unique sources making these sources

Note Each of the six intervals will always be returned regardless of if usage was seen over that time period or not.


Have suggestions or feedback on this Beta API? Please let us know!