Get Corpus Document Count Data

GET

/api/v2/analytics/corpora/document-counts

API endpoint for retrieving document count statistics for specified corpora.

Version:

2.1.0

Changelog:

v2.1.0: Added time series data support with bucket_type parameter

v2.0.0: New API version for corpus document count data.

GET Parameters:

corpus_id (str): List of corpus IDs to filter by (can be specified multiple times as corpus_id=1&corpus_id=2)
include_types (bool): Whether to include document type breakdown (default: true)
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)

Returns:

JSON response containing document count data for the specified corpora

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/api/v2/analytics/corpora/document-counts' \
--header 'Ocp-Apim-Subscription-Key;'

Response Example

200 - Response without document types

{
    "success": true,
    "message": "Corpus document data retrieved successfully",
    "data": {
        "document_counts": [
            {
                "corpus_name": "Example Corpus",
                "total_documents": 100
            }
        ]
    }
}

Request

Authorization

API Key

Add parameter in header

Ocp-Apim-Subscription-Key

Example:

Ocp-Apim-Subscription-Key: ********************

Query Params

Responses

🟢200OK

application/json

Body

🟠403Forbidden

🟠405405

🔴500Server Error

Get Agent Vote Data

Get Corpus Indexing Mode Data