eBay Seller Service Metrics API
Browse all Ebay APIs★ Only Publicly Available OpenAPI DocumentAnalyticsBusiness Intelligenceoauth24 EndpointsREST
For Agents
Pull eBay seller performance metrics, standards profiles, and per-listing traffic to monitor account health and listing visibility.
Use for: I want to monitor my eBay seller defect rate, Get the projected seller standards profile for the next cycle, Retrieve impressions and clicks for my listings this week, Check whether the seller is at risk of dropping below standard
Not supported: Does not handle order management, listing creation, or financial settlement - use for reading eBay seller analytics and traffic data only.
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.
Install Jentic One Beta
Connect the eBay Seller Service Metrics API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the eBay Seller Service Metrics API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fapi.ebay.com%2Febay-seller-service-metrics-api" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fapi.ebay.com%2Febay-seller-service-metrics-api" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with eBay Seller Service Metrics API.
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
Patterns agents use eBay Seller Service Metrics API for, with concrete tasks.
★ 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.
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.
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.
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.
Search Jentic for 'check ebay seller standing', execute GET /seller_standards_profile across active programs, and emit a daily summary
Key Endpoints
4 endpoints — jentic publishes the only available openapi specification for ebay seller service metrics api, keeping it validated and agent-ready.
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
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
Why Jentic?
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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
Alternatives and complements available in the Jentic catalogue.
Alternative
eBay Seller Service Metrics API (legacy slug)
Same surface published under the original hyphen-bracketed slug
Avoid for new work; only used where existing imports require the bracketed slug
FAQs
Specific to using eBay Seller Service Metrics API through Jentic.
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.
GET STARTED