This API is used to receive data on recently sold eBay listings by scraping eBay.com
Refine the request by filtering by keywords, excluded phrases, category, and aspect values. Aspect values are category-specific parameters used to search for more precise products. For example: model, condition, carrier, storage.
You will receive the number of total results, the average price of all products searched for, the minimum price, the maximum price, and the price and more information on each individual product.
This API is a POST methods and requires body data.
The URL you will be getting data from
POST https://ebay-average-selling-price.p.rapidapi.com/findCompletedItems
Returns all data for completed sales
/findCompletedItems
keywords
max_search_results
excluded_keywords
category_id
remove_outliers
site_id
aspects
[
{
"name": "Model",
"value": "Apple iPhone X"
},
{
"name": "Storage Capacity",
"value": "64 GB"
}
]
{
"success": true,
"average_price": 226.47,
"median_price": 220.5,
"min_price": 149.99,
"max_price": 319,
"results": 189,
"response_url": "https://www.ebay.com/sch/9355/i.html?_nkw=iPhone+-locked+-cracked+-case+-box+-read+-LCD+-face&LH_Sold=1&LH_Complete=1&_ipg=240&Model=Apple%2520iPhone%2520X&LH_ItemCondition=3000&Network=Unlocked&Storage%2520Capacity=256%2520GB",
"products": [
{
"title": "Apple iPhone X - 256GB - (Unlocked) - Works Great - (#8076)",
"sale_price": 211.99,
"date_sold": "Jun 11, 2022",
"link": "https://www.ebay.com/itm/185450226888?hash=item2b2db1e4c8%3Ag%3AEmwAAOSw8DJierSB&LH_ItemCondition=3000"
},
{
"title": "Apple iPhone X 256GB Unlocked Silver White A1901 iOS 13.6",
"sale_price": 269,
"date_sold": "Jun 11, 2022",
"link": "https://www.ebay.com/itm/115419688300?epid=239160803&hash=item1adf8cad6c%3Ag%3ASQkAAOSwUWRiiTwo&LH_ItemCondition=3000"
},
{
"title": "Apple iPhone X GSM Smartphone - Space Gray/256GB/Unlocked",
"sale_price": 207.5,
"date_sold": "Jun 11, 2022",
"link": "https://www.ebay.com/itm/394105212129?epid=28039771047&hash=item5bc2804ce1%3Ag%3AGusAAOSw-cpinkmi&LH_ItemCondition=3000"
},
...
]
curl --location --request POST 'https://ebay-sold-items-api.herokuapp.com/findCompletedItems' \
--header 'Content-Type: application/json' \
--data-raw '{
"keywords": "iPhone",
"excluded_keywords": "locked cracked case box read LCD face",
"max_search_results": "240",
"category_id": "9355",
"remove_outliers": true,
"site_id": "0",
"aspects": [
{
"name": "Model",
"value": "Apple iPhone X"
},
{
"name": "LH_ItemCondition",
"value": "3000"
},
{
"name": "Network",
"value": "Unlocked"
},
{
"name": "Storage Capacity",
"value": "256 GB"
}
]
}'
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://ebay-sold-items-api.herokuapp.com/findCompletedItems',
'headers': {
'Content-Type': 'application/json'
},
body: JSON.stringify({
"keywords": "iPhone",
"excluded_keywords": "locked cracked case box read LCD face",
"max_search_results": "240",
"category_id": "9355",
"remove_outliers": true,
"site_id": "0",
"aspects": [
{
"name": "Model",
"value": "Apple iPhone X"
},
{
"name": "LH_ItemCondition",
"value": "3000"
},
{
"name": "Network",
"value": "Unlocked"
},
{
"name": "Storage Capacity",
"value": "256 GB"
}
]
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
import json
url = "https://ebay-sold-items-api.herokuapp.com/findCompletedItems"
payload = json.dumps({
"keywords": "iPhone",
"excluded_keywords": "locked cracked case box read LCD face",
"max_search_results": "240",
"category_id": "9355",
"remove_outliers": True,
"site_id": "0",
"aspects": [
{
"name": "Model",
"value": "Apple iPhone X"
},
{
"name": "LH_ItemCondition",
"value": "3000"
},
{
"name": "Network",
"value": "Unlocked"
},
{
"name": "Storage Capacity",
"value": "256 GB"
}
]
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
If you've noticed that every once in a while your requests will take well over 10 seconds, there is a reason for that. eBay requires a captcha to be solved every few hours when requesting data for sold items. When our server detects a captcha is required, it will automatically solve it and send you the results for the data once it is available, but this can take a few seconds to complete. A captcha is only required once every few hours, but should not affect the success rate or results of the data.
Some aspects on eBay have a different url value then what is shown on the site. If the aspect is not working, make sure that aspect can be used with the category you have selected. Then visit the response_url and select the aspect you want shown. Navigate to the url bar and look for a substring where the new aspect was updated. For example eBay shows "condition" as one of the aspect names, but the actual value in the url is "LH_ItemCondition", and the valeus are condition id's and not condition names.
Conditions on eBay have correlated ids. These ids can be found here: https://developer.ebay.com/devzone/finding/callref/enums/conditionIdList.html Not all conditions work for every category. Make sure you visit the response_url to see what aspects you can use.
Reach out to us through RapidAPI and we will update our API and help you with anything.