Documentation for fingerprinting-api.com. These APIs allow you to secure your website or application against scraping, bots, attacks and other various threats and understand your users behaviors in a cookieless world.
This API uses an API key for authentication. To interact with the API, you will need to provide your API key in the x-api-key header of your requests. 2. Include your API key in the request headers as x-api-key: YOUR_API_KEY.
When querying data, you can use the filter_groups parameter to filter results based on specific attributes. The filter_groups object consists of a list of filters defined by the FilerGroupSchema, where each filter is composed of an object, field, operator, and value. This allows for flexible filtering across various dimensions like country, city, browser, or page.
AND and OR Filters: To apply an AND condition (e.g., filter by both A and B), include both filters in the same filters list within a single filter group. To apply an OR condition (e.g., filter by either A or B), place each filter in separate filter_groups. Each filter group operates independently, so results will match any group that evaluates as true.
If you want to filter data to only see visitors from a specific city using a specific browser (AND condition), your filter might look like this:
{
"filter_groups": [
{
"filters": [
{ "object": "city", "field": "name", "operator": "contains", "value": "New York" },
{ "object": "browser", "field": "name", "operator": "is_any_of", "value": ["Chrome"] }
]
}
]
}If you want to filter data for either visitors from a specific city OR visitors using a specific browser (OR condition), you would structure the filter like this:
{
"filter_groups": [
{
"filters": [
{ "object": "city", "field": "name", "operator": "contains", "value": "New York" }
]
},
{
"filters": [
{ "object": "browser", "field": "name", "operator": "contains", "value": "Chrome" }
]
}
]
}curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/cities?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "label": "string", "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/countries?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "label": "string", "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/pages?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total",
"value": -1
}
}'[ { "avg_duration": 0, "full_url": "string", "total": 0, "visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/states?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "label": "string", "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/traffic/campaigns?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "label": "string", "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/traffic/channels?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "label": "string", "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/traffic/sources?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "label": "string", "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/user-agent/browsers?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/user-agent/devices?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/user-agent/extensions?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/user-agent/os?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "total_visits",
"value": -1
}
}'[ { "average_duration": 0, "name": "string", "total_visits": 0, "unique_visitors": 0 } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/visitors?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "created",
"value": -1
}
}'[ { "company": { … }, "first_seen": "string", "id": "string", "last_seen": "string" } ]
curl -i -X POST \
'https://doc.fingerprinting-api.com/_mock/apis/visits?end_date=2024-11-28&start_date=1970-01-01' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"filter_groups": [],
"pagination": {
"current_page": 1,
"limit": 100
},
"sort_params": {
"key": "created",
"value": -1
}
}'[ { "browser": { … }, "date": "string", "device": { … }, "id": "string", "ip": "string", "location": { … }, "params": {}, "referrer": "string", "screen": { … }, "timezone": "string", "trafficSource": { … }, "url": "string", "visitor_id": "string" } ]