Skip to main content
The Stats API provides access to aggregated analytics data for your search engines — search volumes, click-through rates, conversion metrics, facet usage, and more. All data is read-only. Version: v2

​
Base URL

Example: https://eu1-api.doofinder.com

​
Authentication

JWT authentication is also supported. See the Authentication guide.

​
Common Query Parameters

Most endpoints accept these parameters to define the reporting window:

​
Endpoint Groups

Usage & Sessions

Session counts, user activity, geographic breakdowns, and per-engine usage.

Searches

Search volume, top queries, popular terms, location data.

Clicks & Interactions

Click-through rates, clicked items, position analysis, redirects.

Conversions & Sales

Checkout and sales data attributed to search sessions.

Features

Banners, facets, custom results, recommendations, quizzes.

​
Usage & Sessions

Track how users are engaging with your search engine over time.

​
Searches

Understand what your users are searching for.

​
Clicks & Interactions

Measure how users interact with search results.

​
Conversions & Sales

Attribute revenue and conversions to search-driven sessions.

​
Features

Track usage of specific Doofinder features.

​
Key Metrics Explained

​
Click-Through Rate (CTR)

The ratio of search sessions that result in at least one click. A low CTR on a query suggests results are not relevant.

​
Zero Results Rate

The percentage of searches that return no results. Monitor GET /api/v2/stats/searches for queries with total_results: 0.

​
Session Attribution

Doofinder attributes a sale or checkout to a search session if the user clicked a search result and subsequently completed a purchase within the same session window.