Negotiation API
ebay · Commerce
The Negotiations API gives sellers the ability to proactively send discount offers to buyers who have shown an "interest" in their listings. By sending buyers discount offers on listings where they have shown an interest, sellers can increase the velocity of their sales. There are various ways for a buyer to show interest in a listing. For example, if a buyer adds the listing to their Watch list, or if they add the listing to their shopping cart and later
Authentication
Sample Requests
This method evaluates a seller's current listings and returns the set of IDs that are eligible for a seller-initiated discount offer to a buyer. A listing ID is returned only when one or more buyers have shown an "interest" in the listing. If any buyers have shown interest in a listing, th
Hover any highlighted part to learn what it does
| X-EBAY-C-MARKETPLACE-ID | example |
curl -X GET "https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/find_eligible_items?limit=10&offset=0" \ -H "X-EBAY-C-MARKETPLACE-ID: example"
import requests
params = {
"limit": "10",
"offset": "0"
}
headers = {
"X-EBAY-C-MARKETPLACE-ID": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/find_eligible_items",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/find_eligible_items');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');
const response = await fetch(url, {
headers: {
'X-EBAY-C-MARKETPLACE-ID': 'example'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/find_eligible_items")
q := baseURL.Query()
q.Set("limit", "10")
q.Set("offset", "0")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
req.Header.Set("X-EBAY-C-MARKETPLACE-ID", "example")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/find_eligible_items")
uri.query = URI.encode_www_form({
"limit" => "10",
"offset" => "0"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
req["X-EBAY-C-MARKETPLACE-ID"] = "example"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/find_eligible_items?" . http_build_query([
"limit" => "10",
"offset" => "0"
]);
$opts = ["http" => [
"method" => "GET",
"header" => implode("\r\n", [
"X-EBAY-C-MARKETPLACE-ID: example"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));This method sends eligible buyers offers to purchase items in a listing at a discount. When a buyer has shown interest in a listing, they become "eligible" to receive a seller-initiated offer to purchase the item(s). Sellers use findEligibleItems to get the set of listings that have intere
Hover any highlighted part to learn what it does
| X-EBAY-C-MARKETPLACE-ID | example |
curl -X POST "https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/send_offer_to_interested_buyers" \ -H "X-EBAY-C-MARKETPLACE-ID: example"
import requests
headers = {
"X-EBAY-C-MARKETPLACE-ID": "example"
}
response = requests.post(
"https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/send_offer_to_interested_buyers",
headers=headers,
)
print(response.json())const url = 'https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/send_offer_to_interested_buyers';
const response = await fetch(url, {
method: 'POST',
headers: {
'X-EBAY-C-MARKETPLACE-ID': 'example'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
targetURL := "https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/send_offer_to_interested_buyers"
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-EBAY-C-MARKETPLACE-ID", "example")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/send_offer_to_interested_buyers")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-EBAY-C-MARKETPLACE-ID"] = "example"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/sell-negotiation/v1.1.0/send_offer_to_interested_buyers";
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-EBAY-C-MARKETPLACE-ID: example"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Negotiation API?
Negotiation API is a Commerce API. Developers commonly use commerce APIs for:
- syncing product catalogues and inventory levels
- building price comparison and deal-finder tools
- processing orders and tracking shipments
- managing customer wishlists and reviews
- automating abandoned-cart and promotional emails
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Negotiation API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?