Recommendation API
ebay · Commerce
The Recommendation API returns information that sellers can use to optimize the configuration of their listings on eBay. Currently, the API contains a single method, findListingRecommendations . This method provides information that sellers can use to configure Promoted Listings ad campaigns to maximize the visibility of their items in the eBay marketplace.
Authentication
Sample Requests
The find method currently returns information for a single recommendation type (AD) which contains information that sellers can use to configure Promoted Listings ad campaigns. The response from this method includes an array of the seller's listing IDs, where each element in the array contains recom
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-recommendation/1.1.0/find?limit=10&filter=example&offset=0" \ -H "X-EBAY-C-MARKETPLACE-ID: example"
import requests
params = {
"limit": "10",
"filter": "example",
"offset": "0"
}
headers = {
"X-EBAY-C-MARKETPLACE-ID": "example"
}
response = requests.post(
"https://api.apis.guru/v2/specs/ebay.com/sell-recommendation/1.1.0/find",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/ebay.com/sell-recommendation/1.1.0/find');
url.searchParams.set('limit', '10');
url.searchParams.set('filter', 'example');
url.searchParams.set('offset', '0');
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"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/sell-recommendation/1.1.0/find")
q := baseURL.Query()
q.Set("limit", "10")
q.Set("filter", "example")
q.Set("offset", "0")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
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-recommendation/1.1.0/find")
uri.query = URI.encode_www_form({
"limit" => "10",
"filter" => "example",
"offset" => "0"
})
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-recommendation/1.1.0/find?" . http_build_query([
"limit" => "10",
"filter" => "example",
"offset" => "0"
]);
$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 Recommendation API?
Recommendation 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. Recommendation 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?