canonical: https://jentic.com/apis/api.ebay.com/ebay-seller-service-metrics-api

# eBay Seller Service Metrics API

Jentic publishes the only available OpenAPI specification for eBay Seller Service Metrics API, keeping it validated and agent-ready. This surface exposes the analytics that drive an eBay seller's standing - customer service metrics, the seller standards profile per program and cycle, and a per-listing traffic report covering impressions, clicks, and CTR. It is published under the unbracketed slug and is functionally identical to sell-analytics. Authentication is OAuth 2.0 with the analytics-read scope.

## For AI agents

Pull eBay seller performance metrics, standards profiles, and per-listing traffic to monitor account health and listing visibility.

## Scope

Does not handle order management, listing creation, or financial settlement - use for reading eBay seller analytics and traffic data only.

## Capabilities

- Retrieve a customer service metric by metric type and evaluation type
- List every seller standards profile across programs and cycles
- Fetch a specific seller standards profile by program and cycle
- Generate a traffic report covering impressions, clicks, and CTR per listing
- Filter results by date range and marketplace to slice analytics by region

## Use cases

### Standing forecast for high-volume sellers

Operations teams managing high-volume eBay accounts can poll GET /seller_standards_profile daily and compare CURRENT to PROJECTED cycles to detect drops before the cycle closes. This protects Top Rated discounts and search visibility.

Example prompt: Call GET /seller_standards_profile, compare CURRENT and PROJECTED for each program, alert when PROJECTED drops below ABOVE_STANDARD

### Listing traffic optimisation

Listing optimisation tools call GET /traffic_report to identify low-CTR listings and feed them into image, title, and price test queues. The endpoint supports dimension and metric query parameters so the response can be grouped by listing and filtered by marketplace.

Example prompt: Call GET /traffic_report grouped by listing for the last 30 days and return the 20 lowest-CTR listings

### Customer-service metric benchmarking

Customer-service teams fetch GET /customer_service_metric/{customer_service_metric_type}/{evaluation_type} with PEER_BENCHMARK to see how the seller compares to peers in the same category. The breakdown highlights which categories drag the metric.

Example prompt: Call GET /customer_service_metric/SHIPPING_TIME/PEER_BENCHMARK and return categories where the seller's rate exceeds the benchmark

### Agent-driven daily health digest via Jentic

An AI agent acting as a virtual eBay account manager can search Jentic for the seller-standards operation, run it daily, and emit a one-paragraph digest of changes worth a human reviewing. Jentic stores the OAuth credential so the agent never holds the raw token.

Example prompt: Search Jentic for 'check ebay seller standing', execute GET /seller_standards_profile across active programs, and emit a daily summary

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /customer_service_metric/{customer_service_metric_type}/{evaluation_type} | Retrieve a customer service metric |
| GET | /seller_standards_profile | List seller standards profiles |
| GET | /seller_standards_profile/{program}/{cycle} | Get a profile by program and cycle |
| GET | /traffic_report | Pull listing impressions, clicks, and CTR |

## Key resources

- **customer_service_metric** — Retrieve a specific customer service metric
- **seller_standards_profile** — List or fetch the seller standards profile by program and cycle
- **traffic_report** — Pull listing impressions, clicks, and CTR

## Why Jentic

- **Setup:** Wiring the eBay Seller Service Metrics API by hand means running eBay's OAuth 2.0 user-token flow to obtain the sell.analytics.readonly scope, refreshing access tokens, and handling the dimension and metric query parameters on the traffic report yourself. Through Jentic you install once, import the eBay Seller Service Metrics API from the API Directory, store the OAuth credentials once, and your agent calls it.
- **Permission scoping:** This surface is read-only analytics tied to the authenticated seller through the OAuth token, and program and cycle travel in the path only to select which profile to read, so scope your agent to the operations it needs: for example allow the seller standards profile and traffic report reads. You choose the operations it may call, so nothing beyond these read operations is included unless you add it.
- **Credential handling:** Your eBay OAuth client and refresh tokens are stored once, encrypted, by your own Jentic One instance and an access token is minted per call at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'check eBay seller standing' or 'find listings with declining click-through rate', and Jentic returns the matching operation like GET /seller_standards_profile or GET /traffic_report with its program, cycle, and dimension input schema so the agent calls it without reading the eBay docs.

## Related APIs

- **eBay Sell Analytics API** — Same 4 endpoints under the modern sell- namespace
- **eBay Seller Service Metrics API (legacy slug)** — Same surface published under the original hyphen-bracketed slug
- **eBay Sell Account API** — Sell Account is where the policies that drive these metrics are configured
- **eBay Sell Compliance API** — Sell Compliance surfaces violations that often correlate with traffic drops

## FAQ

### Why is there no official OpenAPI spec for eBay Seller Service Metrics API?

eBay does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call eBay Seller Service Metrics API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Seller Service Metrics API use?

OAuth 2.0 with the analytics-read scope (https://api.ebay.com/oauth/api_scope/sell.analytics.readonly), obtained via eBay's user-token flow. Through Jentic, the OAuth credentials are stored encrypted in your Jentic One instance and access tokens are minted per call.

### How does this slug differ from sell-analytics?

Both surfaces share the same 4 endpoints and contract. seller-service-metrics-api uses the unbracketed legacy publication slug; sell-analytics uses the modern sell- namespace. Choose whichever matches your existing tooling.

### Can I retrieve the projected seller standards profile through Jentic?

Yes. Install with `pip install jentic`, search Jentic for `check ebay seller standing`, load the schema for GET /seller_standards_profile/{program}/{cycle}, populate program (e.g., PROGRAM_US) and cycle PROJECTED, and execute.

### What are the rate limits for the Seller Service Metrics API?

Seller-facing eBay APIs follow the standard daily call limit - typically 5,000 calls per day per application key in production, with per-second burst caps. Verify the exact ceiling on your keyset in the eBay Developer Program dashboard.

### What is the difference between PEER_BENCHMARK and CURRENT evaluation types?

PEER_BENCHMARK compares the seller's metric against peers in the same category. CURRENT returns the seller's own absolute value for the period. Use PEER_BENCHMARK for relative position; use CURRENT for trend tracking.

### Can I limit what my agent is allowed to do with the eBay Seller Service Metrics API?

Yes. Jentic One runs self-hosted, so your own rules decide which of this API's operations and credentials the agent may use. This surface is read-only analytics tied to the authenticated seller through the OAuth token, so you can allow just the operations the agent needs, such as the seller standards profile reads (GET /seller_standards_profile and GET /seller_standards_profile/{program}/{cycle}) and the traffic report read (GET /traffic_report), while leaving out the customer service metric read. Because you choose the operations it may call, nothing beyond the reads you grant is available to the agent.