Ebay Sell Compliance API
Browse all Ebay APIs66
AI ReadinessAI-Aware (B)66/100
Official vendor OpenAPI document · agent-readyE CommerceStorefrontoauth22 EndpointsREST
For Agents
Detect which seller listings violate eBay listing policies. Two endpoints - summary counts and per-listing detail with recommended fixes.
Use for: List all listings with compliance violations on EBAY_US, Get a summary of how many listings have RESTRICTED_ITEM violations, Find all listings flagged for missing item specifics, Retrieve the recommended fix for a specific listing's compliance violation
Not supported: Does not handle listing creation, fixing violations, or order management - use for detecting non-compliant listings against eBay policies only.
The eBay Sell Compliance API tells sellers which of their active listings violate, or are at risk of violating, eBay listing policies - restricted-item rules, missing item specifics, image quality, brand-protection flags, regional take-back disclosures, and others. Two endpoints cover the full surface - /listing_violation_summary returns a count of violations grouped by compliance type, and /listing_violation returns the per-listing detail (listingId, violation reason, recommended fix). Sellers wire it into their listing-management tools so they catch and resolve violations before eBay suppresses or removes the listings.
Install Jentic One Beta
Connect the Sell Compliance API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Sell Compliance 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%2Febay.com%2Fsell-compliance" | 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%2Febay.com%2Fsell-compliance" | 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 Sell Compliance API.
List per-listing compliance violations grouped by violation type
Read summary counts of violations across the seller's active inventory
Filter violations by compliance type (e.g., RESTRICTED_ITEM, MISSING_PHOTO, ITEM_SPECIFICS)
Read recommended remediation actions for each detected violation
Track at-risk listings before eBay applies enforcement actions like search demotion or removal
Use Cases
Patterns agents use Sell Compliance API for, with concrete tasks.
★ Compliance triage queue in a listing tool
Listing-management tools call /listing_violation_summary nightly to render a triage dashboard - total violations bucketed by compliance type, with the highest-impact buckets surfaced first. The seller drills into a bucket and the tool calls /listing_violation with the matching compliance_type filter to show every offending listingId and its recommended fix, ready for one-click remediation.
Call /listing_violation_summary, identify the bucket with the highest count, then call /listing_violation filtered to that compliance_type and return the full listing list
Pre-removal alerting
Sellers want to know about at-risk listings before eBay actually demotes or removes them. The integration polls /listing_violation on a daily schedule and pipes any AT_RISK status results into a notification system (Slack, email). The seller fixes the listing through the Inventory API before the violation is enforced, preserving impressions and avoiding a status hit.
Poll /listing_violation daily, filter to entries with violationStatus=AT_RISK, and post a Slack message with each listingId and reason
Bulk fix workflow
When eBay rolls out a new item-specifics requirement (e.g., a new mandatory aspect for a category), thousands of older listings can become non-compliant overnight. The integration runs /listing_violation filtered to compliance_type=ITEM_SPECIFICS, groups the results by category, and feeds them into a bulk update job that fills the missing aspect via the Sell Inventory API.
Pull /listing_violation with compliance_type=ITEM_SPECIFICS, group by primaryCategoryId, and produce one Inventory API update payload per category
AI agent integration via Jentic
An AI agent that polices a seller's catalogue searches Jentic for 'list eBay listings with compliance violations'. Jentic returns the /listing_violation operation, the agent loads its schema, and executes the call with a User access token issued through Jentic's vault. For each violation, the agent reads the recommendedAction string and proposes a fix that the seller can accept or reject in chat.
Use Jentic to search 'list eBay listings with compliance violations', load /listing_violation, and execute it; for each entry, generate a one-line summary of the recommendedAction
Key Endpoints
2 endpoints — the ebay sell compliance api tells sellers which of their active listings violate, or are at risk of violating, ebay listing policies - restricted-item rules, missing item specifics, image quality, brand-protection flags, regional take-back disclosures, and others.
METHOD
PATH
DESCRIPTION
GET
/listing_violation_summary
Get a count of compliance violations grouped by type
GET
/listing_violation
Get per-listing compliance violation detail with recommended fixes
GET
/listing_violation_summary
Get a count of compliance violations grouped by type
GET
/listing_violation
Get per-listing compliance violation detail with recommended fixes
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
C
Compliance API
- AI-Aware (B)66/100
74
Foundational Compliance69
Developer Experience & Jentic Compatibility46
AI-Readiness & Agent Experience94
Agent Usability90
Security63
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
74
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A-Signals: 4
94%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
0%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
69
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: B+Signals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
75%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
46
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: DSignals: 4
83%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
0%
Summary Coverage
Coverage of summaries across operations/tags/info.
94
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
94%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
90
Security
Trust, risk posture, and security compliance.
Grade: A+Signals: 1
90%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
63
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: B-Signals: 1
62%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the eBay Sell Compliance API by hand means implementing eBay's OAuth 2.0 authorization-code flow for a seller user token, refreshing it, and pointing requests at the api.ebay.com sell/compliance host. Through Jentic you install once, import the Sell Compliance API from the API Directory, store the eBay OAuth credentials once, and your agent calls it.
Permission scoping
This API exposes two flat read endpoints, /listing_violation and /listing_violation_summary, with no resource id in the URL path, so scope it by operation: you limit the agent to reading violation summaries or violation detail. Both are read-only detection calls, so the agent reports non-compliant listings and cannot change them.
Credential isolation
Your eBay OAuth seller credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'find eBay listings with compliance violations', and Jentic returns the matching /listing_violation or /listing_violation_summary operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Sell Compliance API through Jentic.
What authentication does the Sell Compliance API use?
The Sell Compliance API uses OAuth 2.0 with the Authorization Code grant - both endpoints run in the seller's context, so a User access token is required. Through Jentic, the seller's refresh token sits in your Jentic One instance and the agent receives only a scoped access token for the sell.compliance.readonly scope.
Can I see exactly which listings violate a policy with the Sell Compliance API?
Yes. /listing_violation returns one entry per offending listingId with the compliance_type, the violation reason, the violationStatus (AT_RISK or NON_COMPLIANT), and a recommendedAction string describing the fix. Filter the call by compliance_type to focus on a single rule set.
What are the rate limits for the Sell Compliance API?
Sell Compliance falls under the Sell APIs user-context daily quota issued per application-and-user pair. Call /user_rate_limit on the Developer Analytics API and inspect the sell.compliance entry to read the live remaining count for the authenticated seller.
How do I poll for at-risk listings through Jentic?
Search Jentic for 'list eBay listings with compliance violations', load GET /listing_violation, and execute it with filter 'violationStatus:AT_RISK'. Run it on a schedule (daily is typical). Install with pip install jentic. Get started with Jentic One, the self-hosted execution layer.
What compliance_type values does the API report?
Common values include RESTRICTED_ITEM, MISSING_PHOTO, ITEM_SPECIFICS, PRODUCT_ADOPTION, CATEGORY_PLACEMENT, BRAND_PROTECTION, and BUYER_ABUSE_DEFLECTION. The full enumeration is published per marketplace and can change as eBay introduces new policy categories - check the response field rather than hard-coding the list.
Does fixing a listing remove it from /listing_violation immediately?
Updates flow through eBay's compliance evaluation pipeline, which typically refreshes within minutes to hours after a Sell Inventory API update. Treat /listing_violation as eventually consistent - re-poll after the fix to confirm the violation has cleared.
Can I limit what my agent is allowed to do with the eBay Sell Compliance API?
Yes. Because Jentic One is self-hosted, your own rules decide which of this API's operations the agent may call, and you scope it by operation across the two endpoints: reading violation summaries via /listing_violation_summary, reading per-listing violation detail via /listing_violation, or both. Both endpoints are read-only detection calls with no resource id in the path, so the agent can report non-compliant listings but cannot change or remove them. The eBay OAuth seller credentials are held by your own Jentic One instance and injected only at execution time, never exposed to the agent.
GET STARTED