Guides

Patterns Within Signals

If you have access to the Signals endpoint, and receive Email Signals, Signal Patterns can provide even more value! Adding patternInterval to the request:

curl -X POST \
  https://api.fideo.ai/signals  \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
      "phone" : "+1-555-123-4567",
      "patternInterval" : "month"
  }'

{
    "emails": [
        {
            "firstSeenMs": 1155686400000,
            "lastSeenMs": 1723492176917,
            "observations": 82,
            "confidence": 0.95,
            "md5": "22a5ecd674b22e29bec720cfc2470b88",
            "sha1": "4bebf08e30296301382ec74e2b96ebce911d51ed",
            "sha256": "aa8d77230c56099e85626ff92ae7d62b390085a48dd1d950786b59698577a6fc",
            "month": {
                "hits": 0,
                "sources": 0
            }
        },
        {
            "firstSeenMs": 1464503446000,
            "lastSeenMs": 1721433600000,
            "observations": 61,
            "confidence": 0.99,
            "md5": "8ded8555ad3d1791b7978999b41f9563",
            "sha1": "267fd3f441dbca8822a2b36dfdec9b52460c5475",
            "sha256": "32ac819682345c4d78dbbfe238de1b71f06dacc1768e99aab9d05f8e745e3e09",
            "month": {
                "hits": 2,
                "sources": 2
            }
        },
        {
            "firstSeenMs": 1492464135715,
            "lastSeenMs": 1723389069000,
            "observations": 221,
            "confidence": 0.95,
            "md5": "b85f9d5ef2524d22831faffe48acd9b",
            "sha1": "c15bbc711d51aeca8272bcd57027e663ad919463",
            "sha256": "95ca3bdb059292f09b2c64a334eed102400f4f2338c45b5f8f00e4387eaa7c70",
            "month": {
                "hits": 1,
                "sources": 1
            }
        }
    ]
}

Unlike the Time Series and Historical Summary endpoints, this endpoint allows for summaries and pattern details for multiple emails in a given response. This request will provide recency summaries for each email attached to the input. See the response tab above for a detailed example.

Supported Pattern interval values are:

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

For each email in the response, under provided patternInterval key (hour, day, week, etc) two additional values 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

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