API Documentation - SellerNova

Getting Started

The SellerNova API allows you to programmatically access your own marketplace seller analytics and insights generated by our platform, automate workflows, and build custom integrations for your business. All API requests require authentication using an API key.

Base URL

https://api.sellernova.com/v1

Authentication

Include your API key in the Authorization header of each request:

Authorization: Bearer YOUR_API_KEY

Key Features

🔐

Secure Authentication

OAuth 2.0 and API key authentication

⚡

Real-time Data

Access real-time analytics from your own seller account

📊

Comprehensive Analytics

Detailed profit, loss, and performance metrics

🚀

High Performance

Fast response times with 99.9% uptime

Core Endpoints

Profit Analytics

GET /profits/summary

Get profit summary for a date range

Parameter	Type	Description
start_date *	string	Start date (YYYY-MM-DD)
end_date *	string	End date (YYYY-MM-DD)
marketplace	string	Marketplace region (default: US)

Example Request:

curl -X GET "https://api.sellernova.com/v1/profits/summary?start_date=2024-01-01&end_date=2024-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response:

{
  "status": "success",
  "data": {
    "total_revenue": 45678.90,
    "total_costs": 23456.78,
    "net_profit": 22222.12,
    "profit_margin": 48.7,
    "period": {
      "start": "2024-01-01",
      "end": "2024-01-31"
    }
  }
}

Products

GET /products

List all products with performance metrics

GET /products/{asin}

Get detailed metrics for a specific product

Orders

GET /orders

List orders with profit calculations

GET /orders/{order_id}

Get detailed order information

Inventory

GET /inventory

Get current inventory levels and forecasts

POST /inventory/alerts

Set up inventory alert thresholds

PPC Campaigns

GET /ppc/campaigns

List all PPC campaigns with performance data

GET /ppc/campaigns/{campaign_id}/performance

Get detailed campaign performance metrics

Rate Limits

API rate limits vary by plan:

Starter: 1,000 requests/hour
Professional: 10,000 requests/hour
Enterprise: 100,000 requests/hour

Rate limit information is included in response headers:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9999
X-RateLimit-Reset: 1640995200

Error Handling

The API uses standard HTTP status codes. Error responses include a message explaining what went wrong:

{
  "status": "error",
  "error": {
    "code": "INVALID_DATE_RANGE",
    "message": "End date must be after start date"
  }
}

Common Status Codes

200 OK: Request successful
400 Bad Request: Invalid parameters
401 Unauthorized: Invalid or missing API key
404 Not Found: Resource not found
429 Too Many Requests: Rate limit exceeded
500 Internal Server Error: Server error

SDKs & Libraries

We provide official SDKs for popular programming languages:

Python: pip install sellernova
Node.js: npm install sellernova
PHP: composer require sellernova/sdk
Ruby: gem install sellernova

API Support

Need help with the API? We're here to assist:

Email: [email protected]
API Status: status.sellernova.com
GitHub: github.com/sellernova/api-docs

SellerNova API