Перейти к основному содержимому

Subtask 1-3: Ozon API GitHub Repositories and OpenAPI Specs

Discovery Date​

2026-02-10

Primary GitHub Client Libraries​

1. gam6itko/ozon-seller (PHP) - ⭐ RECOMMENDED​

Repository: https://github.com/gam6itko/ozon-seller

Statistics:

  • Stars: 93
  • Forks: 47
  • Watchers: 8
  • Releases: 46 (latest: v0.23.0 - Nov 24, 2025)
  • Commits: 330
  • License: MIT
  • Language: PHP (92.5%), HTML (7.5%)

Key Features:

  • Well-documented with comprehensive README
  • Multiple examples in /examples folder
  • Test suite with good coverage
  • PSR-18 and PSR-17 compliant (HTTP Client and Factories)
  • Compatible with Symfony and standalone PHP applications
  • Script to check if endpoint is implemented: bin/is_realized.php

Documentation:

Installation:

composer require gam6itko/ozon-seller

Implementation Coverage:

  • Multiple service versions: V1, V2, V3, V4
  • Organized by service categories (Product, Posting, Finance, etc.)
  • Utility script to check endpoint implementation: 
    php bin/is_realized.php | grep /v2/posting/fbs/get

Strengths:

  • Most popular PHP implementation
  • Actively maintained (latest release Nov 2025)
  • Comprehensive documentation and examples
  • Good test coverage
  • Clear examples for Categories, Posting, and Products

Structure:

src/
├── Service/
│   ├── V1/ (Categories, Products, etc.)
│   ├── V2/
│   │   ├── Posting/
│   │   │   ├── CrossborderService
│   │   │   ├── FboService
│   │   │   └── FbsService
│   ├── V3/
│   └── V4/
tests/Service/ (more examples)
examples/

2. diPhantxm/ozon-api-client (Go)​

Repository: https://github.com/diPhantxm/ozon-api-client

Package Documentation: https://pkg.go.dev/github.com/diphantxm/ozon-api-client

Key Features:

  • Comprehensive Go client for Ozon Seller API
  • Good test coverage with CI/CD
  • Includes webhook/notification support
  • Full Go package documentation available

Installation:

go get github.com/diphantxm/ozon-api-client

Usage Example:

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/diphantxm/ozon-api-client/ozon"
)

func main() {
    opts := []ozon.ClientOption{
        ozon.WithAPIKey("api-key"),
        ozon.WithClientId("client-id"),
    }
    client := ozon.NewClient(opts...)

    resp, err := client.Products().GetProductDetails(context.Background(), &ozon.GetProductDetailsParams{
        ProductId: 123456789,
    })
    if err != nil {
        log.Fatalf("error: %s", err)
    }

    for _, barcode := range resp.Result.Barcodes {
        fmt.Printf("Barcode %s\n", barcode)
    }
}

Notifications/Webhook Support:

import "github.com/diphantxm/ozon-api-client/ozon/notifications"

server := notifications.NewNotificationServer(5000)
server.Register(notifications.ChatClosedType, func(req interface{}) error {
    notification := req.(*notifications.ChatClosed)
    log.Printf("chat %s has been closed\n", notification.ChatId)
    return nil
})
server.Run()

Structure:

ozon-api-client/
├── ozon/ (main package)
│   ├── Products()
│   ├── Posting()
│   ├── Finance()
│   └── ... (other services)
└── ozon/notifications/
    ├── ChatClosedType
    ├── NewNotificationServer()
    └── notification handlers

Strengths:

  • Comprehensive API coverage
  • Built-in webhook/notification server
  • Well-documented with examples
  • Type-safe Go implementation
  • Active test suite

3. salacoste/ozon-daytona-seller-api (TypeScript) - ⭐ MOST COMPREHENSIVE​

Repository: https://github.com/salacoste/ozon-daytona-seller-api

Documentation: https://salacoste.github.io/ozon-daytona-seller-api/

Statistics:

  • Language: TypeScript
  • Coverage: 278 API methods across 33 categories
  • Status: Production-ready
  • CI/CD: Comprehensive pipeline
  • Test Coverage: 95%+
  • Documentation: 40+ documentation files

Key Features:

  • Complete TypeScript SDK for OZON Seller API
  • All methods in alphabetical order
  • Complete TypeScript typing
  • Live search functionality on documentation site
  • Framework integrations
  • Enterprise-grade implementation

NPM Package:

npm install ozon-daytona-seller-api

Coverage:

  • 278 methods total
  • 33 categories including:
    • Products, Orders, Finance, Analytics
    • FBO, FBS, rFBS
    • Categories, Prices, Stocks
    • Returns, Promotions, Packaging
    • Shipping, Documents, Invoices
    • Chats, Search, Recommendations
    • Performance, Quality, Certificates
    • Labels, Tariffs, Warehouses, Supplies
    • And 15+ additional categories

Strengths:

  • Most comprehensive single-source documentation
  • Production-ready with excellent CI/CD
  • Complete type definitions
  • Interactive documentation website
  • Alphabetically organized methods
  • High test coverage (95%+)
  • Regularly updated

4. Additional Client Libraries​

irenicaa/ozon-seller (Python)​

Repository: https://github.com/irenicaa/ozon-seller

Features:

  • Python client library
  • Uses dataclasses for all requests and responses
  • Automatic JSON handling
  • Clean Pythonic API

PyPI: Available via pip

skeeks-semenov/yii2-ozon-seller-api (PHP - Yii2)​

Repository: https://github.com/skeeks-semenov/yii2-ozon-seller-api

Framework: Yii2 PHP Framework

Features:

  • Yii2 extension for Ozon Seller API
  • Integrates with Yii2 framework
  • Component-based architecture

totalcrm/ozon-php-sdk (PHP)​

Repository: https://github.com/totalcrm/ozon-php-sdk

Features:

  • Alternative PHP implementation
  • PHP library by TotalCRM

ghost-gopher/ozon-api (Python)​

Repository: https://github.com/ghost-gopher/ozon-api

Description: Ozon Common API

Features:

  • Python implementation
  • Includes Seller API for products, reports, sales strategies, warehouses
  • Plans for Performance API integration
  • Includes other Ozon APIs beyond Seller API

feeleen/OzonSellerApi (C#/.NET)​

Repository: https://github.com/feeleen/OzonSellerApi

Description: OZON Seller API client library demo

Language: C# / .NET

OpenAPI/Swagger Specifications​

Official OpenAPI Specification​

URL: https://docs.ozon.ru/api/seller/swagger.json

Status:

  • Official Ozon Seller API Swagger specification
  • Hosted on Ozon's documentation server
  • Not available as a public GitHub repository
  • Must be accessed directly from Ozon's servers

Note: This is the authoritative OpenAPI specification for the Ozon Seller API.

OpenAPI Tooling​

salacoste/openapi-mcp-swagger​

Repository: https://github.com/salacoste/openapi-mcp-swagger

Description: Convert any Swagger/OpenAPI to searchable MCP server

Features:

  • Contains openapi-data/swagger.json (262KB)
  • Described as "Ozon API ready to use"
  • Tool for working with OpenAPI specifications
  • Can be used to generate searchable API documentation

OpenAPI-Based Implementations​

Multiple GitHub repositories mention being maintained according to OpenAPI/Swagger specifications:

  • gam6itko/ozon-seller (PHP) - references official docs
  • diPhantxm/ozon-api-client (Go) - follows OpenAPI patterns
  • salacoste/ozon-daytona-seller-api (TypeScript) - generated from OpenAPI

Pattern: Most client libraries are either:

  1. Generated from the official swagger.json
  2. Manually maintained following OpenAPI patterns
  3. Updated when Ozon updates their specification

GitHub Topics and Collections​

GitHub Topic Pages​

ozon-seller-api​

URL: https://github.com/topics/ozon-seller-api

Featured Repositories:

  • Asynchronous Python library with rate limiting and automatic retries
  • Updated December 2025
  • Multiple language implementations

ozon-api​

URL: https://github.com/topics/ozon-api

Featured Repositories:

  • TypeScript SDK (278 methods, 33 categories)
  • Python implementations
  • PHP implementations
  • Go implementations

ozon-integration​

URL: https://github.com/topics/ozon-integration

Featured Repositories:

  • TypeScript SDK for OZON Seller API
  • Integration libraries and tools
  • Updated January 13, 2026

Ozon Official GitHub​

ozontech​

Organization: https://github.com/ozontech

Repositories:

ozonru​

Organization: https://github.com/orgs/ozonru/repositories

Note: Limited public repositories for Seller API specifically

Other Notable Repositories​

tdkomplekt/ozon-api​

Repository: https://github.com/tdkomplekt/ozon-api

Features:

  • Alternative implementation
  • Community-maintained

s1berc0de/ozon-api-client (Go Fork)​

Repository: https://github.com/s1berc0de/ozon-api-client

Features:

  • Fork or alternative Go implementation
  • Based on ozon-api-client structure

andmetoo/ozon-api-client (Go Fork)​

Repository: https://github.com/andmetoo/ozon-api-client

Package: https://pkg.go.dev/github.com/andmetoo/ozon-api-client

Features:

  • Alternative Go implementation
  • Fork of diPhantxm/ozon-api-client

bryxosmmm/ozon-api-client (Go Fork)​

Repository: https://github.com/bryxosmmm/ozon-api-client

Package: https://pkg.go.dev/github.com/bryxosmmm/ozon-api-client/ozon

Features:

  • Another Go fork
  • Custom modifications or extensions

Community Resources​

GitHub Gists​

Ozon Postman Collection​

Gist: https://gist.github.com/solaryssky/93dca51c3c715f8e0ef713f9545b8640

File: Ozon.postman_collection.json

Description:

  • Community-created Postman collection
  • Sample endpoints for Products category
  • Valid authentication headers and request format examples

Blog Posts and Articles​

Habr Article (Go)​

URL: https://habr.com/ru/articles/724344/

Description:

  • Russian article about working with Ozon API in Go
  • May include code examples and best practices

Key Findings Summary​

Best Client Libraries by Language:​

TypeScript:

  1. salacoste/ozon-daytona-seller-api ⭐
    • Most comprehensive (278 methods, 33 categories)
    • Production-ready with 95%+ test coverage
    • Interactive documentation website
    • Regular updates

PHP:

  1. gam6itko/ozon-seller ⭐
    • Most popular (93 stars, 47 forks)
    • Actively maintained (v0.23.0 - Nov 2025)
    • Well-documented with examples
    • PSR compliant

Go:

  1. diPhantxm/ozon-api-client ⭐
    • Comprehensive coverage
    • Good documentation (pkg.go.dev)
    • Includes webhook support
    • Active test suite

Python:

  1. irenicaa/ozon-seller

    • Dataclass-based implementation
    • Clean Pythonic API
    • Available on PyPI

  2. Async Python library (via ozon-seller-api topic)

    • Asynchronous implementation
    • Rate limiting and automatic retries
    • Updated December 2025

OpenAPI Specification Status:​

✅ Official swagger.json exists: https://docs.ozon.ru/api/seller/swagger.json ❌ No public GitHub repository for the specification ✅ Multiple client libraries reference or generate from the specification ✅ Tooling available for working with OpenAPI (salacoste/openapi-mcp-swagger)

Repository Activity (as of 2026-02-10):​

RepositoryLanguageLatest ReleaseStarsStatus
gam6itko/ozon-sellerPHPNov 24, 2025 (v0.23.0)93✅ Active
diPhantxm/ozon-api-clientGoRecent-✅ Active
salacoste/ozon-daytona-seller-apiTypeScriptJan 2026-✅ Active
irenicaa/ozon-sellerPython--✅ Stable

Implementation Coverage Comparison:​

Most Comprehensive:

  1. salacoste/ozon-daytona-seller-api (TypeScript) - 278 methods, 33 categories

Most Popular:

  1. gam6itko/ozon-seller (PHP) - 93 stars, well-documented

Best for Webhooks:

  1. diPhantxm/ozon-api-client (Go) - Built-in notification server

Best for Python:

  1. irenicaa/ozon-seller - Dataclass-based, clean API
  2. Async Python library (topic page) - Async with rate limiting

Usage Recommendations​

For Complete API Reference:​

  • Use: salacoste/ozon-daytona-seller-api documentation
  • Why: 278 methods documented with live search

For Production PHP Projects:​

  • Use: gam6itko/ozon-seller
  • Why: Most stable, well-tested, PSR compliant

For Go Projects with Webhooks:​

  • Use: diPhantxm/ozon-api-client
  • Why: Built-in notification server support

For Quick Reference:​

Missing Resources​

❌ No dedicated OpenAPI spec repository on GitHub

  • The official swagger.json is only available on docs.ozon.ru
  • No community-maintained OpenAPI spec repository found
  • Most implementations reference the official specification directly

Next Steps (For Subtask 1-4 and Phase 2)​

  1. ✅ Subtask 1-3: Complete - GitHub repositories cataloged
  2. Subtask 1-4: Check PyPI and npm for ozon-api-client packages
  3. Phase 2: Extract detailed API information from these sources:
    • Use TypeScript SDK for comprehensive endpoint list
    • Cross-reference with PHP and Go implementations
    • Extract authentication patterns from all libraries
    • Document rate limiting from code examples

Verification Checklist​

✅ Found and cataloged: gam6itko/ozon-seller (PHP) ✅ Found and cataloged: diPhantxm/ozon-api-client (Go) ✅ Found and cataloged: salacoste/ozon-daytona-seller-api (TypeScript) ✅ Searched for OpenAPI spec repositories ✅ Documented official swagger.json location ✅ Catalogued additional client libraries (Python, C#, etc.) ✅ Identified GitHub topics for ongoing updates ✅ Found community resources (Gists, blog posts) ✅ Compared implementation coverage across languages

Research Completed: 2026-02-10 Verification: Manual confirmation of repository accessibility and documentation Status: ✅ COMPLETE

Sources​