Get Query Count Data

GET

/api/v2/query-counts/

API endpoint for retrieving overall query count data aggregated by date.

Version:

2.0, 2.1

Changelog:

v2.0: Original API version for query count data.

v2.1: Added ISO formatted date field for more precise date handling.

GET Parameters:

type (str): Query type ('fixed' or 'range')
days (int): Number of days to look back (for 'fixed' type)
start_date (str): Start date in ISO format (for 'range' type)
end_date (str): End date in ISO format (for 'range' type)
time_series (bool): Whether to return data in time series format
bucket_type (str): Type of time bucket ('day', 'week', 'month')
limit (int): Number of top entities to return per date bucket (default: 10)

Headers:

X-API-Version (str, optional): API version to use (e.g., '2.0', '2.1'). Defaults to latest.

Returns:

JSON response containing query/interaction count data aggregated by date

Request

Query Params

Header Params

Responses

🟢200OK

application/json

Body

🟠403Forbidden

🟠405405

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https:///api/v2/query-counts/?bucket_type=day&days=30&end_date=2024-03-31&limit=10&start_date=2024-03-01&time_series=true&type=fixed' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Standard Response

{
    "success": true,
    "message": "Overall query  data retrieved successfully",
    "data": {
        "query_data": [
            [
                {
                    "date": "2024-05-01",
                    "interaction_count": 320
                },
                {
                    "date": "2024-05-02",
                    "interaction_count": 285
                },
                {
                    "date": "2024-05-03",
                    "interaction_count": 412
                }
            ]
        ]
    }
}

Get Vote Count Data

Get Token Data