Time Series
This endpoint gives a defined time series response for a given input email.
curl -X POST \
https://api.fideo.ai/beta/signals/patterns/timeseries \
-H 'Authorization: Bearer {Your API Key}' \
-H "Content-Type: application/json" \
-d '{
"email" : "[email protected]"
"interval" : "month",
"count" : 6
}'
{
"2024-09-01": {
"observations": 6,
"sources": 3,
"events": [
{
"type": "visitor",
"observations": 6,
"sources": 3
}
]
},
"2024-08-01": {
"observations": 1,
"sources": 1,
"events": [
{
"type": "id_resolution",
"observations": 1,
"sources": 1
}
]
},
"2024-07-01": {
"observations": 1,
"sources": 1,
"events": [
{
"type": "signup",
"observations": 1,
"sources": 1
}
]
},
"2024-06-01": {
"observations": 19,
"sources": 3,
"events": [
{
"type": "visitor",
"observations": 16,
"sources": 3
},
{
"type": "id_resolution",
"observations": 3,
"sources": 1
}
]
},
"2024-05-01": {
"observations": 1,
"sources": 1,
"events": [
{
"type": "signup",
"observations": 1,
"sources": 1
}
]
},
"2024-04-01": {
"observations": 1,
"sources": 1,
"events": [
{
"type": "click",
"observations": 1,
"sources": 1
}
]
}
}
The above request will give the number of times and number of sources Fideo has seen the email [email protected] in the last 6 months.
A request will three attributes in the request:
- An input plaintext
email
(Note: email hashes are NOT supported) - A desired
interval
. Se the interval table below for valid intervals. - The
count
of how many data points. This value willl be the most recent data points for that interval.
All dates and times are returned in the UTC time zone.
Supported Interval and Counts
Interval Type | Minimum Count | Maximum Count | Output Key Format |
---|---|---|---|
minute | 1 | 360 | yyyy-MM-dd HH:mm:00 |
hour | 1 | 36 | yyyy-MM-dd HH:00:00 |
day | 1 | 60 | yyyy-MM-dd 00:00:00 |
month | 1 | 24 | yyyy-MM-01 |
Note -- the zeros ("00") above in the output key format reflect that these values are always zero. Similarly for the month, the day will always be "01". This was done to minimize the need to parse different key format.
Have suggestions or feedback on this Beta API? Please let us know!
Updated 24 days ago