Subtask 2-7 Findings: Analytics (Аналитика) Category Endpoints
Task: Extract complete endpoint list for Analytics (Аналитика) category Date: 2026-02-10 Status: ✅ COMPLETED
Executive Summary
Successfully extracted 4 endpoints from the Analytics (Аналитика) category, covering comprehensive analytics operations including data retrieval, warehouse stock reports, stock turnover analysis, and stock management operations.
Source: PyPI ozon-api-client package (Auto-generated Swagger client from official OpenAPI spec) API Classes: AnalyticsAPIApi, BetaMethodApi Total Endpoints: 4
Complete Analytics (Аналитика) Endpoint List
| # | HTTP Method | Path | Method Name | Description (RU) | Description (EN) |
|---|---|---|---|---|---|
| 1 | POST | /v1/analytics/data | analytics_api_analytics_get_data | Данные аналитики | Analytics data |
| 2 | POST | /v2/analytics/stock_on_warehouses | analytics_api_analytics_get_stock_on_warehouses_v2 | Отчёт по остаткам и товарам | Stock on warehouses report |
| 3 | POST | /v1/analytics/turnover/stocks | analytics_api_stocks_turnover | Оборачиваемость товара | Product turnover rate |
| 4 | POST | /v1/analytics/manage/stocks | analytics_api_manage_stocks | Управление остатками | Stock management |
Endpoint Analysis by Function Type
General Analytics (1 endpoint)
POST /v1/analytics/data- Get comprehensive analytics data with filtering and metrics
Stock Reports (1 endpoint)
POST /v2/analytics/stock_on_warehouses- Get detailed stock reports across warehouses
Stock Turnover (1 endpoint)
POST /v1/analytics/turnover/stocks- Get product turnover rates and inventory performance
Stock Management (1 endpoint)
POST /v1/analytics/manage/stocks- Manage stock levels and inventory (Beta feature)
API Version Distribution
| API Version | Endpoint Count | Percentage |
|---|---|---|
| v1 | 3 | 75.0% |
| v2 | 1 | 25.0% |
Note: v2 endpoint provides enhanced stock-on-warehouses reporting with improved data structure, while v1 endpoints cover general analytics, turnover analysis, and stock management.
Key Observations
1. Focused Analytics Capabilities
The Analytics category provides targeted analytical operations:
- General analytics: Comprehensive data retrieval with multiple metrics
- Stock analytics: Detailed warehouse stock reports and analysis
- Turnover analysis: Product performance and inventory velocity metrics
- Stock management: Beta feature for inventory control
2. Version Evolution
- Enhanced reporting: v2 for stock-on-warehouses (improved data structure)
- Stable operations: v1 endpoints for general analytics, turnover, and management
- Clear upgrade path: v1 → v2 for enhanced stock reporting features
3. Specialized Features
- Multi-dimensional analytics: General analytics endpoint for comprehensive data analysis
- Warehouse-level granularity: Stock-on-warehouses with detailed breakdown
- Performance metrics: Turnover analysis for inventory optimization
- Beta innovation: Stock management feature in active development
4. Integration Points
- Related to Products category (stock analytics by product)
- Related to Stocks category (warehouse inventory management)
- Related to Finance category (sales performance analytics)
- Related to Orders category (demand forecasting analytics)
HTTP Methods Distribution
| HTTP Method | Count | Percentage |
|---|---|---|
| POST | 4 | 100% |
Note: All Analytics endpoints use POST method, consistent with Ozon API design pattern for complex analytical queries and data retrieval.
Endpoint Frequency by Use Case
High Frequency (Daily Analytics)
- Analytics Data (
/v1/analytics/data) - Daily performance monitoring and metrics - Stock on Warehouses v2 (
/v2/analytics/stock_on_warehouses) - Daily inventory tracking
Medium Frequency (Regular Analysis)
- Stock Turnover (
/v1/analytics/turnover/stocks) - Periodic performance analysis
Low Frequency (Ad-hoc/Management)
- Manage Stocks (
/v1/analytics/manage/stocks) - Stock management operations (Beta)
Detailed Endpoint Analysis
General Analytics Endpoints
1. POST /v1/analytics/data
Description: Get comprehensive analytics data with multiple metrics and dimensions Use Cases:
- Sales performance analysis
- Traffic and conversion metrics
- Category performance tracking
- Product-level analytics
- Competitor analysis
- Dashboard data aggregation
Stock Report Endpoints
2. POST /v2/analytics/stock_on_warehouses (RECOMMENDED)
Description: Get enhanced stock reports across all warehouses Use Cases:
- Multi-warehouse inventory tracking
- Stock level monitoring
- Warehouse performance analysis
- Inventory distribution optimization
- Stock-out prediction
- Warehouse transfer planning
Turnover Analysis Endpoints
3. POST /v1/analytics/turnover/stocks
Description: Get product turnover rates and inventory velocity metrics Use Cases:
- Inventory performance optimization
- Slow-moving stock identification
- Fast-moving stock analysis
- Reorder point calculation
- Dead stock detection
- Inventory investment analysis
Stock Management Endpoints
4. POST /v1/analytics/manage/stocks (BETA)
Description: Manage stock levels and inventory operations Use Cases:
- Stock level adjustments
- Inventory optimization
- Automated stock management
- Predictive inventory control
- Note: Beta feature - API may change
Comparison with Other Sources
TypeScript SDK (ozon-daytona-seller-api)
- Total methods: 278 across 33 categories
- Analytics category: Matches extracted endpoints
- Verification: ✅ All 4 endpoints present in TypeScript SDK
GitHub Client Libraries
- gam6itko/ozon-seller (PHP): Implements major analytics endpoints
- diPhantxm/ozon-api-client (Go): Complete analytics API coverage
- Verification: ✅ Endpoints confirmed across major client libraries
Recommendations for Documentation
Phase 3 (Compile Documentation):
- Include all 4 endpoints in the Analytics section
- Group by functionality (General Analytics, Stock Reports, Turnover, Management)
- Provide usage examples for common operations:
- Analytics data retrieval workflow
- Stock-on-warehouses report generation
- Turnover analysis implementation
- Stock management operations
- Note version differences (v1 vs v2)
- Recommend v2 for stock-on-warehouses
- Highlight beta status of manage stocks endpoint
- Cross-reference related categories (Products, Stocks, Finance, Orders)
Implementation Examples to Include:
- General analytics retrieval (analytics data v1)
- Warehouse stock report (stock_on_warehouses v2)
- Turnover analysis (turnover stocks)
- Stock management (manage stocks - beta)
Data Quality Verification
✅ Completeness
- All 4 AnalyticsAPIApi and BetaMethodApi analytics-related endpoints extracted
- No endpoints missing from catalog
- All HTTP methods and paths verified
✅ Accuracy
- Source: Auto-generated from official OpenAPI spec
- Cross-referenced with TypeScript SDK
- Verified against GitHub client libraries
✅ Consistency
- All endpoints use POST method (consistent with Ozon API pattern)
- Path naming conventions followed
- Russian descriptions provided for all endpoints
- Clear version progression (v1 → v2)
Analytics Category Statistics
Endpoint Count by API Class
| API Class | Endpoint Count | Percentage |
|---|---|---|
| AnalyticsAPIApi | 3 | 75.0% |
| BetaMethodApi | 1 | 25.0% |
Functional Distribution
| Function Type | Endpoint Count | Percentage |
|---|---|---|
| General Analytics | 1 | 25.0% |
| Stock Reports | 1 | 25.0% |
| Turnover Analysis | 1 | 25.0% |
| Stock Management | 1 | 25.0% |
Conclusion
Successfully extracted and documented 4 complete endpoints for the Analytics (Аналитика) category from the Ozon Seller API. The extraction is comprehensive, verified against multiple sources, and ready for inclusion in the final documentation.
Key Highlights:
- Comprehensive general analytics data retrieval
- Enhanced warehouse stock reporting (v2)
- Product turnover and inventory velocity analysis
- Beta stock management feature
- Clear API version progression (v1 → v2)
- Multi-dimensional analytics capabilities
Next Steps:
- ✅ Analytics endpoints documented
- ⏭️ Proceed to subtask-2-8: Prices (Цены) and Stocks (Склад) endpoints
- ⏭️ Continue with remaining categories (Returns, Promotions, Others)
Sources
Primary Source
- PyPI ozon-api-client: https://pypi.org/project/ozon-api-client/
- AnalyticsAPIApi class (3 endpoints)
- BetaMethodApi class (1 analytics endpoint)
- 4 total endpoints with complete paths and descriptions
Verification Sources
- TypeScript SDK: https://salacoste.github.io/ozon-daytona-seller-api/
- GitHub gam6itko/ozon-seller: PHP implementation
- GitHub diPhantxm/ozon-api-client: Go implementation
Additional References
- Ozon API Documentation: https://docs.ozon.ru/api/seller/
- Analytics Guide: https://docs.ozon.ru/global/en/seller-performance/analytics/
End of Subtask 2-7 Findings