canonical: https://jentic.com/apis/ebay.com/sell-negotiation

# Ebay Negotiation API

The eBay Negotiation API lets sellers proactively send discounted offers to buyers who have shown interest in their listings, such as adding an item to a watchlist. With two endpoints it identifies eligible items and sends a Send Offer to Interested Buyers (SOIB) discount on those listings. Sellers use it to recover stalled watch-list interest and convert it into completed sales without negotiating one-on-one.

## For AI agents

Find eBay listings eligible for Send Offer to Interested Buyers and send discounted offers to those interested buyers in bulk.

## Scope

Does not handle storewide promotions, coupons, or Promoted Listings campaigns - use for eBay Send Offer to Interested Buyers (SOIB) flows only.

## Capabilities

- Identify listings eligible for Send Offer to Interested Buyers based on buyer engagement signals
- Send a discounted offer to all buyers who watched or expressed interest in a specific listing
- Apply percentage-based or fixed-amount discounts in a single batch offer
- Trigger time-limited offers that expire automatically if buyers do not accept
- Convert dormant watch-list traffic into purchases without manual outreach per buyer

## Use cases

### Win Back Stalled Watch-List Buyers

Buyers add items to their watchlist but often do not check out without a nudge. The Negotiation API lets sellers use findEligibleItems to identify which listings have interested buyers and sendOfferToInterestedBuyers to deliver a discounted offer to them. Conversion typically improves on listings with multiple watchers because the offer arrives in the buyer's eBay messages with a one-click accept flow.

Example prompt: Call GET /find_eligible_items, pick listings with at least 3 watchers, and POST /send_offer_to_interested_buyers with a 10 percent discount on each.

### Programmatic Slow-Inventory Clearance

Sellers with seasonal or aging stock can run a scheduled job that scans for SOIB-eligible listings each week and sends graduated discounts to interested buyers. Rather than relying on listing edits or storewide markdowns, this approach targets the buyers most likely to convert and preserves margin elsewhere. Each offer is tied to a listing and limited to its current pool of interested buyers.

Example prompt: Schedule a weekly job that calls findEligibleItems, filters listings older than 30 days, and sends a 15 percent SOIB offer to interested buyers.

### Targeted Discount Campaigns Without Storewide Markdowns

When sellers want to discount a small group of listings without affecting their broader pricing strategy, the Negotiation API delivers offers only to buyers already engaged with those specific listings. It is narrower than a storewide promotion and does not require a coupon code. This is useful for high-value items where a public discount would erode the perceived value.

Example prompt: Send a fixed-amount $25-off offer to interested buyers on a single high-value listing through POST /send_offer_to_interested_buyers.

### AI Agent Conversion Recovery

An AI agent integrated with a seller's commerce stack can use Jentic to discover and call the Negotiation API on a recurring basis, automatically scanning for SOIB-eligible listings and sending offers based on buyer engagement signals. The agent can also coordinate with the seller's analytics to choose discount levels that protect margin.

Example prompt: Through Jentic, search 'send ebay offer to interested buyers', load the operation schema, and execute it for a list of eligible listingIds with a chosen discount.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /find_eligible_items | List the seller's listings eligible for SOIB |
| POST | /send_offer_to_interested_buyers | Send a discounted offer to interested buyers for chosen listings |

## Key resources

- **find_eligible_items** — Discover listings that qualify for Send Offer to Interested Buyers
- **send_offer_to_interested_buyers** — Deliver a discounted offer to all interested buyers of a listing

## Why Jentic

- **Setup:** Wiring the eBay Negotiation 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/negotiation host. Through Jentic you install once, import the Negotiation API from the API Directory, store the eBay OAuth credentials once, and your agent calls it.
- **Permission scoping:** This API exposes two flat endpoints, /find_eligible_items and /send_offer_to_interested_buyers, with no resource id in the URL path, so scope it by operation: you can limit the agent to finding eligible listings and leave sending offers out unless you add it. That keeps a read-only agent from creating buyer offers.
- **Credential handling:** 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.
- **Discovery method:** Agents search Jentic by intent such as 'send an eBay offer to interested buyers' or 'find eBay eligible listings', and Jentic returns the matching find_eligible_items or send_offer_to_interested_buyers operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **eBay Marketing API** — Storewide promotions, coupons, and Promoted Listings while Negotiation targets specific watchers
- **eBay Fulfillment API** — Order management for completed sales triggered by accepted SOIB offers
- **eBay Account API** — Configures seller policies that govern eligible listings

## FAQ

### What authentication does the eBay Negotiation API use?

The eBay Negotiation API uses OAuth 2.0 (the api_auth scheme) with seller-scoped tokens. Through Jentic, the OAuth client credentials are kept encrypted in your Jentic One instance and the agent only receives short-lived scoped access tokens for each call.

### Can I send discounted offers to interested buyers with the eBay Negotiation API?

Yes. POST /send_offer_to_interested_buyers accepts a listingId list, a discount percentage or amount, and an optional expiry. eBay then notifies eligible interested buyers with a one-click accept flow.

### How do I find listings eligible for the Send Offer feature?

Call GET /find_eligible_items. It returns the seller's listings that qualify for SOIB, including the count of interested buyers per listing so you can prioritise which ones to send offers on.

### What are the rate limits for the eBay Negotiation API?

The Negotiation API shares the eBay Sell API call quota tied to the seller's Application Growth Check tier rather than per-endpoint limits in the spec. Bulk-listing payloads on send_offer_to_interested_buyers reduce call volume at scale.

### How do I send an SOIB offer through Jentic?

Search 'send ebay offer to interested buyers' in Jentic, load the POST /send_offer_to_interested_buyers schema, pass the listingIds and discount, and Jentic executes the call against api.ebay.com on the seller's behalf.

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

Yes. Because you run Jentic One yourself, your own rules decide which of this API's two operations the agent may call and which eBay OAuth credentials it may use. Since both endpoints are flat with no resource id in the path, you scope by operation: allow GET /find_eligible_items so the agent can only read listings eligible for Send Offer to Interested Buyers, and withhold POST /send_offer_to_interested_buyers unless you explicitly grant it. That keeps a read-only agent from sending discounted offers to buyers on your behalf.