eBay Product API
/search?engine=ebay_product API endpoint allows you to scrape the results from the eBay product pages via our SerpApi service. Head to the playground for a live and interactive demo.
API Parameters
Localization
ebay_domain
Optional
Parameter defines the eBay domain to use. It defaults to ebay.com. Head to the eBay domains for a full list of supported domains.
locale
Optional
Parameter defines from where you want the search to originate from. Head to the eBay locales for a full list of supported locales.
Advanced Ebay Parameters
shipping_country
Optional
Parameter defines the shipping country to use for shipping data calculation. Head to the eBay shipping countries for a full list of supported countries.
Serpapi Parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Ebay Product results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
output
Optional
Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.
json_restrictor
Optional
Parameter defines the fields you want to restrict in the outputs for smaller, faster responses. See JSON Restrictor for more details.
API Results
JSON Results
JSON output includes structured data for the product.
A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.
HTML Results
HTML output is useful to debug JSON results or support features not supported yet by SerpApi.
HTML output gives you the raw HTML results from eBay Product.
API Examples
Example for product with shipping to other country
{
"search_metadata": {
"id": "68e7ad4bfd6b6f56072e7cad",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/595aeb2bdd92adbe/68e7ad4bfd6b6f56072e7cad.json",
"created_at": "2025-10-09 12:40:43 UTC",
"processed_at": "2025-10-09 12:40:44 UTC",
"ebay_product_url": "https://www.ebay.com/itm/305576857892",
"raw_html_file": "https://serpapi.com/searches/595aeb2bdd92adbe/68e7ad4bfd6b6f56072e7cad.html",
"total_time_taken": 2.14
},
"search_parameters": {
"engine": "ebay_product",
"product_id": "305576857892",
"ebay_domain": "ebay.com",
"shipping_country": "CA"
},
"product_results": {
"product_id": "305576857892",
"product_link": "http://www.ebay.com/itm/305576857892",
"title": "PlayStation 5 Slim Console + Extra PS5 DualSense Controller Starlight Blue",
"subtitle": "Brand New - Full Warranty",
"short_description": "From pulling back an increasingly tight bowstring to hitting the brakes on a speeding car, feel physically connected to your on-screen actions. Find your voice, share your passion Built-in microphone and headset jack Chat with friends online using the built-in microphone – or by connecting a headset to the 3.5mm jack.",
"full_description_link": "https://itm.ebaydesc.com/itmdesc/305576857892?t=0&category=139971&seller=antonline&excSoj=1&ver=1&excTrk=1&lsite=0&ittenable=true&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
"watch_count": 749,
"banner_status": "In 197 carts",
"buy": {
"options": [
"buy_it_now"
],
"buy_it_now": {
"price": {
"amount": 624.98,
"currency": "USD"
}
}
},
"shipping": {
"from": "Atlanta, GA, United States",
"to": {
"country": {
"name": "Canada",
"iso_code_alpha2": "CA"
}
},
"status": "available",
"options": [
{
"via": "eBay International Shipping",
"price": {
"amount": 190.57,
"currency": "USD"
},
"dates": {
"type": "between",
"list": [
"Thu, Oct 30",
"Fri, Nov 7"
]
}
}
],
"ships_to": {
"snippets": [
{
"text": "Afghanistan, Albania, Algeria, Andorra, Angola, Anguilla, Antigua and Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan Republic, Bahamas, Bahrain, Bangladesh, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia and Herzegovina, Botswana, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde Islands, Cayman Islands, Central African Republic, Chad, Chile, Colombia, Costa Rica, Cyprus, Czech Republic, Côte d'Ivoire (Ivory Coast), Democratic Republic of the Congo, Denmark, Djibouti, Dominican Republic, Ecuador, Egypt, El Salvador, Equatorial Guinea, Eritrea, Estonia, Ethiopia, Fiji, Finland, France, Gabon Republic, Gambia, Georgia, Ghana, Gibraltar, Greece, Greenland, Grenada, Guatemala, Guinea, Guinea-Bissau, Guyana, Honduras, Hungary, Iceland, India, Indonesia, Ireland, Israel, Italy, Jamaica, Japan, Kazakhstan, Kenya, Kiribati, Kuwait, Kyrgyzstan, Latvia, Lebanon, Lesotho, Liberia, Liechtenstein, Lithuania, Luxembourg, Macedonia, Madagascar, Malawi, Maldives, Mali, Malta, Mauritania, Mauritius, Mexico, Moldova, Monaco, Montenegro, Montserrat, Morocco, Mozambique, Namibia, Nauru, Nepal, Netherlands, New Zealand, Nicaragua, Niger, Nigeria, Norway, Oman, Pakistan, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Poland, Portugal, Puerto Rico, Republic of Croatia, Republic of the Congo, Romania, Rwanda, Saint Kitts-Nevis, Saint Lucia, Saint Vincent and the Grenadines, San Marino, Senegal, Serbia, Seychelles, Sierra Leone, Singapore, Slovakia, Slovenia, Solomon Islands, South Korea, Spain, Sri Lanka, Suriname, Swaziland, Sweden, Switzerland, Taiwan, Tajikistan, Tanzania, Thailand, Togo, Tonga, Trinidad and Tobago, Tunisia, Turkey, Turkmenistan, Turks and Caicos Islands, Uganda, United Arab Emirates, United States, Uruguay, Uzbekistan, Vanuatu, Vatican City State, Vietnam, Wallis and Futuna, Western Samoa, Yemen, Zambia, Zimbabwe"
}
]
},
"includes_countries": [
{
"name": "Afghanistan",
"iso_code_alpha2": "AF"
},
{
"name": "Albania",
"iso_code_alpha2": "AL"
},
{
"name": "Algeria",
"iso_code_alpha2": "DZ"
},
...
],
"excludes_countries": [
{
"name": "PO Box"
},
{
"name": "APO/FPO"
},
{
"name": "Alaska/Hawaii"
},
...
],
"handling_time": {
"snippets": [
{
"text": "Will usually ship within 2 business days of receiving cleared payment."
},
{
"text": "Learn more",
"link": "https://www.ebay.com/pages/help/buy/contextual/domestic-handling-time.html"
}
]
},
"duties": {
"price": {
"amount": 0,
"currency": "USD"
},
"snippets": [
{
"text": "eBay is charging this fee to facilitate the import of your item on your behalf and ensure your item arrives without fees due to customs or third party service providers. Import fees may not be refundable."
}
]
}
},
"returns": [
[
{
"title": "Returns",
"snippets": [
{
"text": "With eBay International Shipping, returns accepted within 30 days"
}
]
},
{
"title": "Returns shipping",
"snippets": [
{
"text": "Buyer pays return shipping. If you use an eBay shipping label, it will be deducted from your refund amount"
}
]
},
{
"title": "Refund",
"snippets": [
{
"text": "Money Back"
}
]
},
{
"title": "Return policy",
"snippets": [
{
"text": "Refer to"
},
{
"text": "eBay Return policy",
"link": "https://www.ebay.com/help/policies/member-behavior-policies/condition-returned-items-policy?id=4763"
},
...
]
}
]
],
"payment_methods": {
"payments": [
{
"title": "PayPal"
},
{
"title": "Venmo"
},
{
"title": "Google Pay"
},
...
],
"financing": [
{
"title": "Paypal Credit",
"snippet_groups": [
[
{
"text": "Select PayPal Credit at checkout to have the option to pay over time."
},
{
"text": "Qualifying purchases could enjoy No Interest if paid in full in 6 months on purchases of $149 or more. Other offers may also be available."
},
...
]
]
},
{
"title": "eBay Mastercard®",
"snippet_groups": [
[
{
"text": "Earn up to 5x points when you use your eBay Mastercard®."
},
{
"text": "Learn more",
"link": "https://pages.ebay.com/creditcard"
}
]
]
}
]
},
"media": [
{
"type": "image",
"image": [
{
"link": "https://i.ebayimg.com/images/g/nbQAAOSwIvtmTCx~/s-l140.jpg",
"size": {
"width": 140,
"height": 140
}
},
{
"link": "https://i.ebayimg.com/images/g/nbQAAOSwIvtmTCx~/s-l500.jpg",
"size": {
"width": 500,
"height": 500
}
},
{
"link": "https://i.ebayimg.com/images/g/nbQAAOSwIvtmTCx~/s-l960.jpg",
"size": {
"width": 960,
"height": 960
}
}
]
},
...
],
"specifications": {
"groups": [
{
"type": "about_this_item",
"title": "Item specifics",
"sections": [
{
"type": "features",
"fields": [
{
"type": "condition",
"title": "Condition",
"value": "New: A brand-new, unused, unopened, undamaged item in its original packaging (where packaging is applicable). Packaging should be the same as what is found in a retail store, unless the item is handmade or was packaged by the manufacturer in non-retail packaging, such as an unprinted box or plastic bag. See the seller's listing for full details."
},
{
"type": "brand",
"title": "Brand",
"value": "Sony"
},
{
"type": "type",
"title": "Type",
"value": "Gaming Console"
},
...
]
}
]
}
],
"last_revision_datetime": {
"original": "Oct 09, 2025 00:35:09 PDT",
"iso8601": "2025-10-09T00:35:09-07:00"
},
"revisions_link": "https://www.ebay.com/rvh/305576857892"
},
"categories": [
{
"title": "Electronics",
"link": "https://www.ebay.com/b/Electronics/bn_7000259124"
},
{
"title": "Video Games & Consoles",
"link": "https://www.ebay.com/b/Video-Games-Consoles/1249/bn_1850232"
},
{
"title": "Video Game Consoles",
"link": "https://www.ebay.com/b/Video-Game-Consoles/139971/bn_320033"
}
],
"condition": "New",
"quantity": {
"availability_signal": "More than 10 available",
"available_per_buyer": {
"min": 1,
"max": 41
},
"sold": 346
},
"additional_services": [
{
"id": "303969825703",
"type": "warranty",
"title": "2-year protection plan",
"price": {
"amount": 62.99,
"currency": "USD"
},
"snippets": [
{
"text": "Coverage for product breakdowns and malfunctions"
},
{
"text": "100% Parts and labor, no deductibles"
},
...
]
},
...
],
"shop_with_confidence": [
{
"type": "authorized_seller",
"title": "Sony Authorized seller",
"snippet_groups": [
[
{
"text": "Authorized resellers receive training and product knowledge from the manufacturer."
}
]
]
},
{
"type": "ebay_money_back_guarantee_dollar",
"title": "eBay Money Back Guarantee",
"snippet_groups": [
[
{
"text": "Get the item you ordered or your money back."
},
{
"text": "Learn more",
"link": "https://www.ebay.com/ebay-money-back-guarantee/"
}
]
]
}
]
},
"seller_results": {
"type": "store",
"name": "Antonline",
"username": "antonline",
"ssn": "antonline",
"bio": "For over 30 years, America’s premier online retailer of cutting edge gaming and computer technology.",
"joined_at": "Joined Sep 2002",
"sold_count": 2300000,
"rating": 338567,
"positive_feedback": 99.1,
"profile_link": "https://www.ebay.com/str/antonline",
"logo_link": "https://i.ebayimg.com/images/g/HywAAOSwTM5Y56a2/s-l140.jpg",
"catalog_link": "https://www.ebay.com/sch/i.html?_ssn=antonline",
"popular_categories": {
"list": [
{
"title": "Computers/Tablets & Networking",
"link": "https://www.ebay.com/str/antonline/Computers-Tablets-Networking/_i.html?store_cat=860588619",
"category_id": "860588619"
},
{
"title": "Consumer Electronics",
"link": "https://www.ebay.com/str/antonline/Consumer-Electronics/_i.html?store_cat=860588719",
"category_id": "860588719"
},
...
],
"see_all_link": "https://www.ebay.com/sch/i.html?_dkr=1&iconV2Request=true&_blrs=recall_filtering&_ssn=antonline&store_cat=0&store_name=antonline&_oac=1"
},
"rating_scores": [
{
"title": "Accurate description",
"value": 4.9
},
{
"title": "Reasonable shipping cost",
"value": 5
},
...
],
"reviews": {
"groups": {
"this_product": {
"count": 29,
"list": [
{
"review_id": "2418323742019",
"sentiment": "positive",
"author": {
"username": "c***c",
"rating": 218
},
"text": "Good rolling item condition of item was new the packaging on the other has was damaged",
"created_time": "Past year",
"verified_purchase": true
},
...
]
},
"all_products": {
"count": 364166,
"list": [
{
"review_id": "2499303669019",
"sentiment": "positive",
"author": {
"username": "e***e",
"rating": 299
},
"text": "Brand new/sealed as described. Some small damage to the back right corner of the box, but still affects the appearance. In great shape otherwise! Was a great price, cheaper than their Amazon & Best Buy listings by a few bucks. Shipping was okay, but the carrier didn’t really provide much updates until the day before delivery. Came in an oversized Walmart packed box with air pockets, so probably from their Walmart distribution. Took 5 days from shipping. Overall satisfied. Recommended Seller!",
"image_link": "https://i.ebayimg.com/00/s/MTYwMFgxMjAw/z/lC4AAeSwNUtoyMKs/$_1.JPG?set_id=8800005007",
"created_time": "Past month",
"product": {
"id": "305857931065",
"link": "https://www.ebay.com/itm/305857931065",
"title": "Doom Anthology Xbox - For Xbox Series X and Xbox One - Rated M+17 (Mature) - Fir (#305857931065)"
},
"verified_purchase": true
},
...
]
}
},
"see_all_link": "https://www.ebay.com/fdbk/mweb_profile?fdbkType=FeedbackReceivedAsSeller&item_id=305576857892&username=antonline&filter=feedback_page%3ARECEIVED_AS_SELLER&sort=RELEVANCEV2#tab1"
}
},
"related_products": [
{
"product_id": "146883055815",
"product_link": "https://www.ebay.com/itm/146883055815",
"title": "BRAND NEW PlayStation 5 Slim Console - Includes PS5 Console And DualSense Contro",
"price": {
"amount": 650,
"currency": "USD"
},
"image_link": "https://i.ebayimg.com/thumbs/images/g/pigAAOSwOM1jlzmb/s-l96.jpg",
"extensions": [
"+ shipping"
]
},
{
"product_id": "406263825595",
"product_link": "https://www.ebay.com/itm/406263825595",
"title": "Sony PlayStation 5 Slim Disc PS5 1TB Console With DualSense Controller + Cords",
"price": {
"amount": 399.94,
"currency": "USD"
},
"image_link": "https://i.ebayimg.com/thumbs/images/g/nOwAAeSw9-FoD-MN/s-l96.jpg",
"extensions": [
"+ $9.95 shipping"
]
},
...
]
}
Example for product with variations and price conversion
{
...
"product_results": {
"product_id": "226359420152",
"product_link": "http://www.ebay.com.au/itm/226359420152",
"title": "APPLE IPHONE 15 PRO 128GB 256GB (FACTORY UNLOCKED) ✅NEVER ACTIVATED✅ ❖SEALED❖",
"subtitle": "✈️ FREE 2 DAYS ✈️│✅1 YEAR WARRANTY ✅│🔥 BEST PRICE 🔥",
"short_description": "APPLE IPHONE 15 PRO - 128GB / 256GB (FACTORY UNLOCKED). Apple iPhone 15 PRO - 128GB / 256GB (FACTORY UNLOCKED). Don't worry, we're here to help. NOT included. Wall Adapter is. Sync Cable.",
"full_description_link": "https://vi.vipr.ebaydesc.com/itmdesc/226359420152?t=1726705839000&category=9355&seller=santamonicawireless&excSoj=1&ver=0&excTrk=1&lsite=0&ittenable=false&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1&variationId=525550066166",
"watch_count": 38,
"banner_status": "8 watched in the last 24 hours",
"buy": {
"options": [
"buy_it_now"
],
"buy_it_now": {
"price": {
"amount": 1236.4,
"currency": "AUD"
},
"price_converted_from": {
"amount": 839.95,
"currency": "USD"
}
}
},
"shipping": {
"from": "Los Angeles, California, United States",
"to": {
"country": {
"name": "United States",
"iso_code_alpha2": "US"
},
"zip_code": "46219"
},
"status": "available",
"options": [
{
"via": "Expedited Shipping",
"free": true,
"dates": {
"type": "between",
"list": [
"Thu, 26 Sep",
"Sat, 28 Sep"
]
}
},
{
"via": "UPS Next Day Air®",
"price": {
"amount": 66.24,
"currency": "AUD"
},
"price_converted_from": {
"amount": 45.0,
"currency": "USD"
},
"each_additional_price": {
"amount": 44.16,
"currency": "AUD"
},
"each_additional_price_converted_from": {
"amount": 30.0,
"currency": "USD"
},
"dates": {
"type": "between",
"list": [
"Tue, 24 Sep",
"Wed, 25 Sep"
]
}
}
],
...
},
"returns": [
[
{
"title": "Returns",
"snippets": [
{
"text": "Accepted within 30 days"
}
]
},
...
]
],
"payment_methods": {
"payments": [
{
"title": "PayPal"
},
...
]
},
"media": [
{
"type": "image",
"image": [
{
"link": "https://i.ebayimg.com/images/g/YwcAAOSwcCFm62py/s-l140.jpg",
"size": {
"width": 140,
"height": 140
}
},
...
]
},
...
],
"specifications": {
"groups": [
{
"type": "about_this_item",
"title": "Item specifics",
"sections": [
{
"type": "features",
"fields": [
{
"type": "condition",
"title": "Condition",
"value": "Brand New: A brand-new, unused, unopened, undamaged item in its original packaging (where packaging is applicable). Packaging should be the same as what is available in a retail store, unless the item was packaged by the manufacturer in non-retail packaging, such as an unprinted box or plastic bag. See the seller's listing for full details."
},
...
]
}
]
}
],
"last_revision_datetime": {
"original": "19 Sep, 2024 11:20:51 AEST",
"iso8601": "2024-09-19T11:20:51+03:00"
},
"revisions_link": "https://www.ebay.com.au/rvh/226359420152"
},
"categories": [
{
"title": "Electronics",
"link": "https://www.ebay.com/b/Electronics/bn_7000259124"
},
{
"title": "Cell Phones & Accessories",
"link": "https://www.ebay.com/b/Cell-Phones-Smart-Watches-Accessories/15032/bn_1865441"
},
{
"title": "Cell Phones & Smartphones",
"link": "https://www.ebay.com/b/Cell-Phones-Smartphones/9355/bn_320094"
}
],
"condition": "Brand New",
"quantity": {
"availability_signal": "2 available",
"available_per_buyer": {
"min": 1,
"max": 5
},
"sold": 5
},
"variations": {
"menus": [
{
"id": 1000,
"title": "Color",
"options": [
{
"id": 0,
"title": "Black Titanium"
},
{
"id": 1,
"title": "White Titanium",
"out_of_stock": true
},
...
]
},
{
"id": 1001,
"title": "STORAGE",
"options": [
{
"id": 4,
"title": "128GB"
},
{
"id": 5,
"title": "256GB",
"out_of_stock": true
}
]
}
],
"combinations": [
{
"variation_id": "525550066163",
"menu_option_ids": [
1,
5
],
"price": {
"amount": 1324.72,
"currency": "AUD"
},
"price_converted_from": {
"amount": 899.95,
"currency": "USD"
},
"quantity": {
"availability_signal": "Out of stock",
"out_of_stock": true
}
},
{
"variation_id": "525550066168",
"menu_option_ids": [
2,
4
],
"price": {
"amount": 1236.4,
"currency": "AUD"
},
"price_converted_from": {
"amount": 839.95,
"currency": "USD"
},
"quantity": {
"availability_signal": "3 available",
"available_per_buyer": {
"min": 1,
"max": 3
}
},
"watch_count": 19
},
...
]
},
"shop_with_confidence": [
{
"type": "ebay_money_back_guarantee_dollar",
"title": "eBay Money Back Guarantee",
"snippet_groups": [
[
{
"text": "Get the item you ordered or your money back."
},
{
"text": "Learn more",
"link": "https://www.ebay.com.au/ebay-money-back-guarantee/"
}
]
]
}
]
},
...
}
Example for product with coupon code, lowered price, price conversion and shipping to other country
{
...
"product_results": {
"product_id": "184977780029",
"product_link": "http://www.ebay.com/itm/184977780029",
"title": "MENS ROLEX DATEJUST BLUE ROMAN DIAMOND SAPPHIRE 18K WHITE GOLD STEEL WATCH",
"short_description": "Model: Datejust. Case: Rolex Stainless Steel Case. Wrist Size: Adjustable Rolex Clasp Fits Wrist up to 7.5 in. Bezel: Custom 18K White Gold Sapphire Diamond Bezel. Crystal: Sapphire Crystal. VIEW OUR WATCH COLLECTION.",
"full_description_link": "https://vi.vipr.ebaydesc.com/itmdesc/184977780029?t=1673400062000&category=31387&seller=purewatches&excSoj=1&ver=0&excTrk=1&lsite=0&ittenable=false&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
"watch_count": 59,
"banner_status": "23 viewed in the last 24 hours",
"buy": {
"options": [
"buy_it_now"
],
"buy_it_now": {
"price": {
"amount": 105513.55,
"currency": "ZAR"
},
"price_converted_from": {
"amount": 6099.0,
"currency": "USD"
},
"discount_price": {
"amount": 94962.195,
"currency": "ZAR"
},
"list_price": {
"amount": 6599.0,
"currency": "USD"
}
}
},
"coupon": {
"code": "FLASHTEN",
"savings": {
"amount": 10551.36,
"currency": "ZAR"
},
"snippet_groups": [
[
{
"text": "Automatically applied during checkout"
}
]
]
},
"shipping": {
"from": "Chino Hills, California, United States",
"to": {
"country": {
"name": "Australia",
"iso_code_alpha2": "AU"
}
},
"status": "available",
"options": [
{
"via": "USPS Priority Mail Express InternationalTM",
"price": {
"amount": 1366.71,
"currency": "ZAR"
},
"price_converted_from": {
"amount": 79.0,
"currency": "USD"
},
"dates": {
"type": "between",
"list": [
"Wed, Oct 9",
"Thu, Oct 31"
]
}
}
],
"ships_to": {
"snippets": [
{
"text": "Worldwide"
}
]
},
"includes_countries": [
{
"name": "Argentina",
"iso_code_alpha2": "AR"
},
{
"name": "Australia",
"iso_code_alpha2": "AU"
},
{
"name": "Austria",
"iso_code_alpha2": "AT"
},
...
],
"excludes_countries": [
{
"name": "Afghanistan"
},
{
"name": "Africa"
},
{
"name": "Albania"
},
...
],
"handling_time": {
"snippets": [
{
"text": "Will usually ship within 1 business day of receiving cleared payment."
},
...
]
},
"legal": {
"snippets": [
{
"text": "International shipping - items may be subject to customs processing depending on the item's customs value."
},
{
"text": "Sellers declare the item's customs value and must comply with customs declaration laws."
},
...
]
}
},
"returns": [
[
{
"title": "Returns",
"snippets": [
{
"text": "Accepted within 30 days"
}
]
},
...
]
],
"payment_methods": {
"payments": [
{
"title": "PayPal"
},
...
]
},
"media": [
{
"type": "image",
"image": [
{
"link": "https://i.ebayimg.com/images/g/oKwAAOSwK7phCBDK/s-l140.jpg",
"size": {
"width": 140,
"height": 140
}
},
...
]
},
...
],
"condition": "Pre-owned",
"quantity": {
"availability_signal": "Last one",
"available_per_buyer": {
"min": 1,
"max": 1
},
"sold": 3
}
},
...
}
Example for product in localized interface (without language override)
{
...
"product_results": {
"product_id": "266190900217",
"product_link": "http://www.ebay.com/itm/266190900217",
"title": "Microsoft Xbox シリーズS",
"original_title": "Microsoft Xbox Series S",
"subtitle": "Buy directly from the Microsoft eBay Outlet Store",
"short_description": "Expandable Storage. Accessories radio. Dedicated dual band Xbox Wireless radio. Xbox Series X console. WHAT'S IN THE BOX. 6.5cm x 15.1cm x 27.5cm. VIDEO CAPABILITIES. 802.3 10/100/1000.",
"full_description_link": "https://vi.vipr.ebaydesc.com/itmdesc/266190900217?t=1730876422000&category=139971&seller=microsoft&vipguid=b55230c21930ab1c34574a72ffc3d526&ver=0&excTrk=1&tto=3500&lsite=0&ittenable=false&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
"rating": 4.86,
"review_count": 826,
"watch_count": 3700,
"banner_status": "過去24時間に18人がウォッチ",
"buy": {
"options": [
"buy_it_now"
],
"buy_it_now": {
"price": {
"amount": 45583.0,
"currency": "JPY"
},
"price_converted_from": {
"amount": 299.99,
"currency": "USD"
}
}
},
"shipping": {
"from": "United States, 米国",
"to": {
"country": {
"name": "日本",
"iso_code_alpha2": "JP"
}
},
"status": "available",
"options": [
{
"via": "eBay International Shipping",
"price": {
"amount": 13461.0,
"currency": "JPY"
},
"price_converted_from": {
"amount": 88.59,
"currency": "USD"
},
"dates": {
"type": "between",
"list": [
"1月6日 (月)",
"1月20日 (月)"
]
}
}
],
"ships_to": {
"snippets": [
{
"text": "アイスランド, アイルランド, アゼルバイジャン共和国, アフガニスタン, アラブ首長国連邦, アルジェリア, アルゼンチン, アルバ, アルバニア, アルメニア, アンギラ, アンゴラ, アンティグア・バーブーダ, アンドラ, イエメン, イスラエル, イタリア, インド, インドネシア, ウォリス・フツナ, ウガンダ, ウズベキスタン, ウルグアイ, エクアドル, エジプト, エストニア, エチオピア, エリトリア, エルサルバドル, オマーン, オランダ, オーストラリア, オーストリア, カザフスタン, カナダ, カメルーン, カンボジア, カーボベルデ共和国, ガイアナ, ガボン共和国, ガンビア, ガーナ, キプロス, キリバス, キルギスタン, ギニア, ギニアビサウ, ギリシャ, クウェート, クロアチア共和国, グアテマラ, グリーンランド, グレナダ, ケイマン諸島, ケニア, コスタリカ, コロンビア, コンゴ共和国, コンゴ民主共和国, コートジボワール（象牙海岸）, サンマリノ, ザンビア, シエラレオネ, シンガポール, ジブチ, ジブラルタル, ジャマイカ, ジョージア, ジンバブエ, スイス, スウェーデン, スペイン, スリナム, スリランカ, スロバキア, スロベニア, スワジランド, セイシェル, セネガル, セルビア, セントクリストファー・ネイビス, セントビンセントおよびグレナディーン諸島, セントルシア, ソロモン諸島, タイ, タジキスタン, タンザニア, タークス・カイコス諸島, チェコ共和国, チャド, チュニジア, チリ, デンマーク, トリニダード・トバゴ, トルクメニスタン, トルコ, トンガ, トーゴ, ドミニカ共和国, ナイジェリア, ナウル, ナミビア, ニカラグア, ニジェール, ニュージーランド, ネパール, ノルウェー, ハイチ, ハンガリー, バチカン市国, バヌアツ, バハマ, バミューダ, バングラデシュ, バーレーン, パキスタン, パナマ, パプアニューギニア, パラグアイ, フィジー, フィリピン, フィンランド, フランス, ブルガリア, ブルキナファソ, ブルネイ・ダルサラーム, ブルンジ, ブータン, プエルトリコ, ベトナム, ベナン, ベリーズ, ベルギー, ペルー, ホンジュラス, ボスニア・ヘルツェゴビナ, ボツワナ, ボリビア, ポルトガル, ポーランド, マケドニア, マダガスカル, マラウイ, マリ, マルタ, メキシコ, モザンビーク, モナコ, モルディブ, モルドバ, モロッコ, モンゴル, モンテネグロ, モントセラト, モーリシャス, モーリタニア, ヨルダン, ラオス, ラトビア, リトアニア, リヒテンシュタイン, リベリア, ルクセンブルク, ルワンダ, ルーマニア, レソト, レバノン, 中央アフリカ共和国, 台湾, 日本, 米国, 西サモア, 赤道ギニア, 韓国"
}
]
},
"includes_countries": [
{
"name": "アイスランド",
"iso_code_alpha2": "IS"
},
{
"name": "アイルランド",
"iso_code_alpha2": "IE"
},
{
"name": "アゼルバイジャン共和国",
"iso_code_alpha2": "AZ"
},
...
],
"excludes_countries": [
{
"name": "私書箱"
},
{
"name": "APO・FPO（空軍郵便局・米国海軍郵便局）"
},
{
"name": "アメリカ領サモア"
},
...
],
"handling_time": {
"snippets": [
{
"text": "通常、決済後3営業日以内に発送します。"
},
...
]
},
"duties": {
"price": {
"amount": 0.0,
"currency": "JPY"
},
"price_converted_from": {
"amount": 0.0,
"currency": "USD"
},
"snippets": [
{
"text": "見積額、精算時に確定"
}
]
}
},
"returns": [
[
{
"title": "返品",
"snippets": [
{
"text": "eBay国際配送の場合は、30日以内の返品可"
}
]
},
...
],
...
],
"payment_methods": {
"payments": [
{
"title": "PayPal"
},
...
]
},
"media": [
{
"type": "image",
"image": [
{
"link": "https://i.ebayimg.com/images/g/47AAAOSwTE9kIbkR/s-l140.jpg",
"size": {
"width": 140,
"height": 140
}
},
...
]
},
...
],
"specifications": {
"groups": [
{
"type": "about_this_item",
"title": "商品の詳細",
"sections": [
{
"type": "features",
"fields": [
{
"type": "condition",
"title": "状態",
"value": "New: A brand-new, unused, unopened, undamaged item in its original packaging (where packaging is applicable). Packaging should be the same as what is found in a retail store, unless the item is handmade or was packaged by the manufacturer in non-retail packaging, such as an unprinted box or plastic bag. See the seller's listing for full details."
},
{
"type": "upc",
"title": "UPC",
"value": "889842651317"
},
...
]
}
]
},
{
"type": "product_details",
"title": "この商品について",
"sections": [
{
"type": "product_identifiers",
"title": "Product Identifiers",
"fields": [
{
"type": "brand",
"title": "Brand",
"value": "Microsoft"
},
{
"type": "mpn",
"title": "MPN",
"value": "RRS-00001"
},
...
]
},
{
"type": "product_key_features",
"title": "Product Key Features",
"fields": [
{
"type": "platform",
"title": "Platform",
"value": "S, Microsoft Xbox Series X"
},
{
"type": "region_code",
"title": "Region Code",
"value": "Region Free"
},
...
]
},
...
]
}
],
"last_revision_datetime": {
"original": "2024年12月10日 21時36分23秒 PST"
},
"revisions_link": "https://www.ebay.com/rvh/266190900217"
},
"categories": [
{
"title": "電子機器",
"link": "https://www.ebay.com/b/Electronics/bn_7000259124"
},
{
"title": "ビデオゲームとコンソール",
"link": "https://www.ebay.com/b/Video-Games-Consoles/1249/bn_1850232"
},
{
"title": "ビデオゲームコンソール",
"link": "https://www.ebay.com/b/Video-Game-Consoles/139971/bn_320033"
},
{
"title": "Microsoft Xbox Series Sビデオゲームコンソール",
"link": "https://www.ebay.com/b/Microsoft-Xbox-Series-S-Video-Game-Consoles/139971/bn_7117578289"
},
{
"title": "もっと表示 Microsoft Xbox Series S 512GB Video Game Console - White",
"link": "https://www.ebay.com/p/8040996571"
}
],
"condition": "New",
"quantity": {
"availability_signal": "在庫10点以上",
"available_per_buyer": {
"min": 1,
"max": 1
},
"sold": 2502
},
"shop_with_confidence": [
{
"type": "authorized_seller",
"title": "Microsoftから直売",
"snippet_groups": [
[
{
"text": "ブランド直販の商品。"
}
]
]
},
{
"type": "ebay_money_back_guarantee_dollar",
"title": "eBayの返金保証",
"snippet_groups": [
[
{
"text": "注文した商品が届かない場合はお金が戻ってきます。"
},
{
"text": "詳細",
"link": "https://www.ebay.com/ebay-money-back-guarantee/"
}
]
]
}
]
},
...
}
Example for product in localized interface (with language override)
{
...
"product_results": {
"product_id": "266190900217",
"product_link": "http://www.ebay.com/itm/266190900217",
"title": "Microsoft Xbox Series S",
"subtitle": "Buy directly from the Microsoft eBay Outlet Store",
"short_description": "Expandable Storage. Accessories radio. Dedicated dual band Xbox Wireless radio. Xbox Series X console. WHAT'S IN THE BOX. 6.5cm x 15.1cm x 27.5cm. VIDEO CAPABILITIES. 802.3 10/100/1000.",
"full_description_link": "https://vi.vipr.ebaydesc.com/itmdesc/266190900217?t=1730876422000&category=139971&seller=microsoft&vipguid=b550a1ec1930a57bc6ead977ffc435c8&ver=0&excTrk=1&tto=3500&lsite=0&ittenable=false&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
"rating": 4.86,
"review_count": 826,
"watch_count": 3700,
"banner_status": "5 sold in last 24 hours",
"buy": {
"options": [
"buy_it_now"
],
"buy_it_now": {
"price": {
"amount": 45583,
"currency": "JPY"
},
"price_converted_from": {
"amount": 299.99,
"currency": "USD"
}
}
},
"shipping": {
"from": "United States, United States",
"to": {
"country": {
"name": "Japan",
"iso_code_alpha2": "JP"
}
},
"status": "available",
"options": [
{
"via": "eBay International Shipping",
"price": {
"amount": 13461,
"currency": "JPY"
},
"price_converted_from": {
"amount": 88.59,
"currency": "USD"
},
"dates": {
"type": "between",
"list": [
"Mon, Jan 6",
"Mon, Jan 20"
]
}
}
],
"ships_to": {
"snippets": [
{
"text": "Afghanistan, Albania, Algeria, Andorra, Angola, Anguilla, Antigua and Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan Republic, Bahamas, Bahrain, Bangladesh, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia and Herzegovina, Botswana, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde Islands, Cayman Islands, Central African Republic, Chad, Chile, Colombia, Costa Rica, Cyprus, Czech Republic, Côte d'Ivoire (Ivory Coast), Democratic Republic of the Congo, Denmark, Djibouti, Dominican Republic, Ecuador, Egypt, El Salvador, Equatorial Guinea, Eritrea, Estonia, Ethiopia, Fiji, Finland, France, Gabon Republic, Gambia, Georgia, Ghana, Gibraltar, Greece, Greenland, Grenada, Guatemala, Guinea, Guinea-Bissau, Guyana, Haiti, Honduras, Hungary, Iceland, India, Indonesia, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Liechtenstein, Lithuania, Luxembourg, Macedonia, Madagascar, Malawi, Maldives, Mali, Malta, Mauritania, Mauritius, Mexico, Moldova, Monaco, Mongolia, Montenegro, Montserrat, Morocco, Mozambique, Namibia, Nauru, Nepal, Netherlands, New Zealand, Nicaragua, Niger, Nigeria, Norway, Oman, Pakistan, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Poland, Portugal, Puerto Rico, Republic of Croatia, Republic of the Congo, Romania, Rwanda, Saint Kitts-Nevis, Saint Lucia, Saint Vincent and the Grenadines, San Marino, Senegal, Serbia, Seychelles, Sierra Leone, Singapore, Slovakia, Slovenia, Solomon Islands, South Korea, Spain, Sri Lanka, Suriname, Swaziland, Sweden, Switzerland, Taiwan, Tajikistan, Tanzania, Thailand, Togo, Tonga, Trinidad and Tobago, Tunisia, Turkey, Turkmenistan, Turks and Caicos Islands, Uganda, United Arab Emirates, United States, Uruguay, Uzbekistan, Vanuatu, Vatican City State, Vietnam, Wallis and Futuna, Western Samoa, Yemen, Zambia, Zimbabwe"
}
]
},
"includes_countries": [
{
"name": "Afghanistan",
"iso_code_alpha2": "AF"
},
{
"name": "Albania",
"iso_code_alpha2": "AL"
},
{
"name": "Algeria",
"iso_code_alpha2": "DZ"
},
...
],
"excludes_countries": [
{
"name": "PO Box"
},
{
"name": "APO/FPO"
},
{
"name": "American Samoa"
},
...
],
"handling_time": {
"snippets": [
{
"text": "Will usually ship within 3 business days of receiving cleared payment."
},
...
]
},
"duties": {
"price": {
"amount": 0,
"currency": "JPY"
},
"price_converted_from": {
"amount": 0,
"currency": "USD"
},
"snippets": [
{
"text": "Estimate, final at checkout"
}
]
}
},
"returns": [
[
{
"title": "Returns",
"snippets": [
{
"text": "With eBay International Shipping, returns accepted within 30 days"
}
]
},
...
],
...
],
"payment_methods": {
"payments": [
{
"title": "PayPal"
},
...
]
},
"media": [
{
"type": "image",
"image": [
{
"link": "https://i.ebayimg.com/images/g/47AAAOSwTE9kIbkR/s-l140.jpg",
"size": {
"width": 140,
"height": 140
}
},
...
]
},
...
],
"specifications": {
"groups": [
{
"type": "about_this_item",
"title": "Item specifics",
"sections": [
{
"type": "features",
"fields": [
{
"type": "condition",
"title": "Condition",
"value": "New: A brand-new, unused, unopened, undamaged item in its original packaging (where packaging is applicable). Packaging should be the same as what is found in a retail store, unless the item is handmade or was packaged by the manufacturer in non-retail packaging, such as an unprinted box or plastic bag. See the seller's listing for full details."
},
{
"type": "upc",
"title": "UPC",
"value": "889842651317"
},
...
]
}
]
},
{
"type": "product_details",
"title": "About this product",
"sections": [
{
"type": "product_identifiers",
"title": "Product Identifiers",
"fields": [
{
"type": "brand",
"title": "Brand",
"value": "Microsoft"
},
{
"type": "mpn",
"title": "MPN",
"value": "RRS-00001"
},
...
]
},
{
"type": "product_key_features",
"title": "Product Key Features",
"fields": [
{
"type": "platform",
"title": "Platform",
"value": "S, Microsoft Xbox Series X"
},
{
"type": "region_code",
"title": "Region Code",
"value": "Region Free"
},
...
]
},
...
]
}
],
"last_revision_datetime": {
"original": "Dec 10, 2024 21:36:23 PST",
"iso8601": "2024-12-10T21:36:23-08:00"
},
"revisions_link": "https://www.ebay.com/rvh/266190900217"
},
"categories": [
{
"title": "Electronics",
"link": "https://www.ebay.com/b/Electronics/bn_7000259124"
},
{
"title": "Video Games & Consoles",
"link": "https://www.ebay.com/b/Video-Games-Consoles/1249/bn_1850232"
},
{
"title": "Video Game Consoles",
"link": "https://www.ebay.com/b/Video-Game-Consoles/139971/bn_320033"
},
{
"title": "Microsoft Xbox Series S Video Game Consoles",
"link": "https://www.ebay.com/b/Microsoft-Xbox-Series-S-Video-Game-Consoles/139971/bn_7117578289"
},
{
"title": "See more Microsoft Xbox Series S 512GB Video Game Console - White",
"link": "https://www.ebay.com/p/8040996571"
}
],
"condition": "New",
"quantity": {
"availability_signal": "More than 10 available",
"available_per_buyer": {
"min": 1,
"max": 1
},
"sold": 2502
},
"shop_with_confidence": [
{
"type": "authorized_seller",
"title": "Direct from Microsoft",
"snippet_groups": [
[
{
"text": "Item sold directly by the brand."
}
]
]
},
{
"type": "ebay_money_back_guarantee_dollar",
"title": "eBay Money Back Guarantee",
"snippet_groups": [
[
{
"text": "Get the item you ordered or your money back."
},
{
"text": "Learn more",
"link": "https://www.ebay.com/ebay-money-back-guarantee/"
}
]
]
}
]
},
...
}
Example for product with vehicle report and seller payment instructions
{
...
"product_results": {
"product_id": "256674490872",
"product_link": "http://www.ebay.com/itm/256674490872",
"title": "2009 Honda Civic GX",
"alternative_title": "2009 Honda Civic Sedan White FWD Automatic GX",
"short_description": "Find many great new & used options and get the best deals for 2009 Honda Civic GX at the best online prices at eBay! Free shipping for many products!",
"full_description_link": "https://vi.vipr.ebaydesc.com/itmdesc/256674490872?t=1727334373000&category=6256&seller=jaymenks&excSoj=1&ver=0&excTrk=1&lsite=100&ittenable=true&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
"watch_count": 38,
"banner_status": "53 viewed in the last 24 hours",
"buy": {
"options": [
"bid"
],
"bid": {
"price": {
"amount": 3050.0,
"currency": "USD"
},
"bid_count": 14,
"auction_end_datetime": "2024-10-20T02:08:59Z"
}
},
"shipping": {
"from": "Manassas, Virginia, United States",
"to": {
"country": {
"name": "United States",
"iso_code_alpha2": "US"
},
"zip_code": "49503"
},
"status": "local_pickup",
"local_pickup": {
"snippet_groups": [
[
{
"text": "Buyer responsible"
},
{
"text": "for vehicle pick-up or shipping."
}
],
[
{
"text": "Buyer responsible for vehicle pick-up or shipping"
},
{
"text": "From Manassas, Virginia, United States"
}
]
],
"snippet_highlighted_words": [
"Buyer responsible"
]
},
"ships_to": {
"snippets": [
{
"text": "Will not ship (buyer must pick up)"
}
]
},
...
},
"payment_methods": {
"payments": [
{
"title": "Cash On Pickup"
},
{
"title": "Other (add instructions)"
}
],
"instructions": [
[
{
"text": "Upon auction close, the Buyer will pay $1,000 via Zelle at the minimum. Balance payment is expected via Zelle or within 3 Days or at the time of pickup which ever comes first. Please only bid on this item if you have the funds to pay. Thanks for your cooperation and understanding."
}
]
],
"additional_info": [
[
{
"text": "Full payment is required within 3 days of listing close"
}
]
]
},
...
"vehicle_report": {
"status": "available",
"partner": "Powered By AutoCheck",
"score": {
"value": 71,
"value_range_min": 43,
"value_range_max": 66,
"verdict": "Above range",
"extensions": [
"Similar vehicles score 43 - 66",
"(2009 Car - Compact)"
]
},
"highlights": {
"owner_count": 1,
"title_check": "OK",
"odometer_check": "OK",
"accidents": "None",
"report_date": "October 12, 2024"
},
"full_report_link": "https://www.ebay.com/vmw/vhr?vin=AQAJAAAAIP86fgd%2BhRJZCLg5DqRArO3ouZuoV4RQbK%2B6jEPR603A&sid=AQAJAAAAEOYszFrbYLJn1pIiZ3nyi9Q%3D"
},
"condition": "Used",
"shop_with_confidence": [
{
"type": "vehicle_purchase_protection",
"title": "Vehicle Purchase Protection",
"snippet_groups": [
[
{
"text": "Covers up to $100,000 when your transaction is completed through eBay. Restrictions apply."
},
{
"text": "Learn more",
"link": "https://pages.ebay.com/motors/buy/purchase-protection/index.html"
}
],
[
{
"text": "This vehicle is eligible for up to $100,000 in Vehicle Purchase Protection in the event that you never receive it after you have paid for it or sent a refundable deposit."
},
{
"text": "To qualify for Vehicle Purchase Protection you must be the winning bidder on an auction or click the Buy It Now button directly on the eBay site. Additional eligibility may apply."
},
{
"text": "Please refer to the full terms, conditions and restrictions",
"link": "https://pages.ebay.com/motors/buy/purchase-protection/index.html"
}
]
]
}
]
},
...
}
JSON structure overview
{
...
"product_results": {
"product_id": "String - Unique eBay ID of the product",
"product_link": "String - Link to the product page",
"title": "String - Title of the product",
"original_title": "String - Non-translated product title in case of localized interface",
"alternative_title": "String - Additional title of the product",
"subtitle": "String - Text under all the titles",
"short_description": "String - Short description of the product",
"full_description_link": "String - Link to the full description HTML page",
"rating": "Float - Rating of the product (0.0-5.0)",
"review_count": "Integer - Number of product reviews",
"watch_count": "Integer - Number of people who watch/want/liked the product",
"banner_status": "String - Information banner in the upper left corner of the product image (e.g. `4 watched in the last 24 hours`)",
"urgency_status": "String - Information banner between title and seller section (e.g. `363 people have this in their cart`)",
"buy": {
"options": "Array[String] - Combination of purchase options (`buy_it_now`, `bid` (Auction), `best_offer`)",
"buy_it_now": {
"price": {
"amount": "Float - Main price amount",
"currency": "String - Main price currency"
},
"price_converted_from": {
"amount": "Float - Non-converted price amount in case of localized interface",
"currency": "String - Non-converted price currency in case of localized interface"
},
"discount_price": {
"amount": "Float - Main price amount after applying coupon code",
"currency": "String - Main price currency after applying coupon code"
},
"list_price": {
"amount": "Float - Original price amount if main price is lowered",
"currency": "String - Original price currency if main price is lowered"
},
"additional_info": [
{
"text": "String - Additional purchase info snippet text",
"link": "String - Additional purchase info snippet link"
},
...
]
},
"bid": {
"price": {
"amount": "Float - Last bid price amount",
"currency": "String - Last bid price currency"
},
"price_converted_from": {
"amount": "Float - Last bid non-converted price amount in case of localized interface",
"currency": "String - Last bid non-converted price currency in case of localized interface"
},
"bid_count": "Integer - Number of auction bids",
"auction_end_datetime": "String - Auction end datetime in ISO 8601 format (e.g. `2024-09-17T20:47:37Z`)",
"reserve_price_not_met": "Boolean - Indicates whether reserve price threshold hasn't been reached yet"
}
},
"coupon": {
"code": "String - Coupon code",
"savings": {
"amount": "Float - Amount of savings",
"currency": "String - Currency of savings"
},
"snippet_groups": [
[
{
"text": "String - Coupon info snippet text",
"link": "String - Coupon info snippet link"
},
...
],
...
]
},
"shipping": {
"from": "String - Location of the product",
"to": {
"country": {
"name": "String - Destination country name (localized)",
"iso_code_alpha2": "String - Destination country ISO 3166-1 alpha-2 code"
},
"zip_code": "String - Destination ZIP code"
},
"status": "String - Shipping availability status (`available`, `not_available`, `local_pickup`, `may_not_ship`)",
"options": [
{
"via": "String - Name of the delivery service",
"price": {
"amount": "Float - Main shipping price amount",
"currency": "String - Main shipping price currency"
},
"price_converted_from": {
"amount": "Float - Non-converted shipping price amount in case of localized interface",
"currency": "String - Non-converted shipping price currency in case of localized interface"
},
"each_additional_price": {
"amount": "Float - Shipping price amount of each additional product unit",
"currency": "String - Shipping price currency of each additional product unit"
},
"each_additional_price_converted_from": {
"amount": "Float - Non-converted shipping price amount of each additional product unit in case of localized interface",
"currency": "String - Non-converted shipping price currency of each additional product unit in case of localized interface"
},
"duties": {
"amount": "Float - Shipping option duties amount",
"currency": "String - Shipping option duties currency"
},
"free": "Boolean - Free shipping flag",
"dates": {
"type": "String - Type of the shipping dates formula (`on_or_before` (1 date), `between` (2 dates), `unknown` (more dates))",
"list": "Array[String] - Array of specified dates (e.g. ['Mon, Sep 23', 'Fri, Sep 27'])",
"snippets": [
{
"text": "String - Delivery time info snippet text",
"link": "String - Delivery time info snippet link"
},
...
]
},
"snippets": [
{
"text": "String - Shipping option additional info snippet text",
"link": "String - Shipping option additional info snippet text"
},
...
]
},
...
],
"local_pickup": {
"snippet_groups": [
[
{
"text": "String - Local pickup info snippet text",
"link": "String - Local pickup info snippet link"
},
...
],
...
],
"snippet_highlighted_words": "Array[String] - Highlighted words in local pickup snippet groups"
},
"freight_delivery": {
"snippets": [
{
"text": "String - Freight delivery info snippet text",
"link": "String - Freight delivery info snippet link"
},
...
]
},
"discount": {
"snippets": [
{
"text": "String - Shipping discount info snippet text",
"link": "String - Shipping discount info snippet link"
},
...
]
},
"ships_to": {
"snippets": [
{
"text": "String - Ships to info snippet text",
"link": "String - Ships to info snippet link"
},
...
]
},
"includes_countries": [
{
"name": "String - Name of the country to which shipping is available (localized)",
"iso_code_alpha2": "String - ISO 3166-1 alpha-2 code of the country to which shipping is available"
},
...
],
"excludes_countries": [
{
"name": "String - Name of the country to which shipping is not available (localized)"
},
...
],
"handling_time": {
"snippets": [
{
"text": "String - Handling time info snippet text",
"link": "String - Handling time info snippet link"
},
...
]
},
"legal": {
"snippets": [
{
"text": "String - Shipping legal info snippet text",
"link": "String - Shipping legal info snippet link"
},
...
]
},
"taxes": {
"snippets": [
{
"text": "String - Shipping taxes info snippet text",
"link": "String - Shipping taxes info snippet link"
},
...
]
},
"duties": {
"price": {
"amount": "Float - Shipping duties amount",
"currency": "String - Shipping duties currency"
},
"price_converted_from": {
"amount": "Float - Shipping duties non-converted amount in case of localized interface",
"currency": "String - Shipping duties non-converted currency in case of localized interface"
},
"free": "Boolean - No duties flag",
"snippets": [
{
"text": "String - Shipping duties info snippet text",
"link": "String - Shipping duties info snippet link"
},
...
]
}
},
"returns": [
[
{
"title": "String - Name of the returns section",
"snippets": [
{
"text": "String - Text of the returns section snippet",
"link": "String - Link of the returns section snippet"
},
...
]
},
...
]
],
"payment_methods": {
"payments": [
{
"title": "String - Name of the regular payment method (e.g. `PayPal`, `Visa`, `MasterCard`)"
},
...
],
"financing": [
{
"title": "String - Name of the financing payment method (e.g. `Paypal Credit`)",
"snippet_groups": [
[
{
"text": "String - Financing payment method snippet text",
"link": "String - Financing payment method snippet link"
},
...
],
...
]
}
],
"instructions": [
[
{
"text": "String - Seller payment instructions snippet text",
"link": "String - Seller payment instructions snippet link"
},
...
],
...
],
"additional_info": [
[
{
"text": "String - Payment methods additional info snippet text",
"link": "String - Payment methods additional info snippet link"
},
...
],
...
]
},
"media": [
{
"type": "String - Internal eBay type of the media (e.g. `image`, `video`)",
"image": {
"link": "String - Image link",
"size": {
"width": "Integer - Image width",
"height": "Integer - Image height"
}
},
"video": {
"size": {
"width": "Integer - Video width",
"height": "Integer - Video height"
},
"playlists": [
{
"type": "String - Playlist file type (e.g. `dash`, `hls`)",
"link": "String - Playlist file link"
},
...
]
}
},
...
],
"specifications": {
"groups": [
{
"type": "String - Internal eBay type of the specs group (e.g. `about_this_item`, `product_details`)",
"title": "String - Specs group name (localized) (e.g. `Item specifics`, `Características del artículo`, `商品の詳細`)",
"sections": [
{
"type": "String - Internal eBay type of the specs group section (e.g. `features`, `productIdentifiers`, `productKeyFeatures`)",
"title": "String - Specs group section name (localized) (e.g. `Product Identifiers`, `Identificadores de producto`)"
"fields": [
{
"type": "String - Internal eBay type of the spec field (e.g. `brand`, `upc`, `storageCapacity`)",
"title": "String - Spec field name (localized) (e.g. `Brand`, `Marca`, `Capacidad de almacenamiento`)",
"value": "String - Spec field value"
},
...
]
},
...
]
},
...
],
"last_revision_datetime": {
"original": "String - Datetime of specs last revision in original format (e.g. `Dec 10, 2024 21:36:23 PST`, `2024年12月10日 21時36分23秒 PST`)",
"iso8601": "String - Original datetime converted to ISO 8601 format if possible (e.g. `2024-12-10T21:36:23-08:00`)"
}
"revision_link": "String - Link to the revisions page"
},
"categories": [
{
"title": "String - Product category name",
"link": "String - Link to the product category page"
},
...
],
"vehicle_report": {
"status": "String - Vehicle report availability status (`available`, `available_for_purchase`, `not_available`, `unknown`)",
"partner": "String - Name of the vehicle report provider",
"score": {
"value": "Integer - Report score value",
"value_range_min": "Integer - Common score range min value",
"value_range_max": "Integer - Common score range max value",
"verdict": "String - Verdict based on the score",
"extensions": "Array[String] - Additional details of the score"
},
"highlights": {
"owner_count": "Integer - Number of previous owners of the vehicle",
"title_check": "String - Vehicle title check status",
"odometer_check": "String - Vehicle odometer check status",
"accidents": "String - Vehicle accidents check status",
"report_date": "String - Date of the report (e.g. `October 12, 2024`)"
},
"buy": {
"link": "String - Link to the report purchase page",
"options": [
{
"extensions": "Array[String] - Report purchase details",
"strikethrough_extensions": "Array[String] - Report purchase strikethrough details",
"detected_extensions": {
"price": {
"amount": "Float - Report price amount",
"currency": "String - Report price currency"
},
"list_price": {
"amount": "Float - Report original price amount if main price is lowered",
"currency": "String - Report original price currency if main price is lowered"
}
}
},
...
]
},
"records_found_count": "Integer - Number of records about vehicle found by report provider"
},
"condition": "String - Product condition",
"quantity": {
"availability_signal": "String - Information about product availability",
"available_per_buyer": {
"min": "Integer - Minimal number of product units allowed to be purchased by a single buyer",
"max": "Integer - Maximal number of product units allowed to be purchased by a single buyer"
},
"out_of_stock": "Boolean - Indicates whether product is out of stock",
"sold": "Integer - Number of product units sold"
},
"additional_services": [
{
"id": "String - eBay ID of the additional service",
"type": "String - Internal eBay type of the additional service (e.g. `warranty`)",
"title": "String - Name of the additional service",
"price": {
"amount": "Float - Additional service price amount",
"currency": "String - Additional service price currency"
},
"snippets": [
{
"text": "String - Additional service snippet text",
"link": "String - Additional service snippet link"
},
...
]
},
...
],
"variations": {
"menus": [
{
"id": "Integer - ID of the variations dropdown",
"title": "String - Name of the variations dropdown",
"options": [
{
"id": "Integer - ID of the variation dropdown option",
"title": "String - Name of the variation dropdown option",
"out_of_stock": "Boolean - `Out of stock` flag of variation dropdown option",
"most_popular": "Boolean - `Most popular` flag of variation dropdown option"
},
...
]
},
...
],
"combinations": [
{
"variation_id": "String - ID of the options variation",
"menu_option_ids": "Array[Integer] - Combination of dropdown option IDs",
"price": {
"amount": "Float - Variation price amount",
"currency": "String - Variation price currency"
},
"price_converted_from": {
"amount": "Float - Variation non-converted price amount in case of localized interface",
"currency": "String - Variation non-converted price currency in case of localized interface"
},
"quantity": {
"availability_signal": "String - Information about selected variation availability",
"available_per_buyer": {
"min": "Integer - Minimal number of product variation units allowed to be purchased by a single buyer",
"max": "Integer - Maximal number of product variation units allowed to be purchased by a single buyer"
},
"out_of_stock": "Boolean - Indicates whether product variation is out of stock",
},
"watch_count": "Integer - Number of people who watch/want/liked selected product variation",
"additional_service_ids": "Array[String] - IDs of additional services available for the selected product variation",
"bulk_options": [
{
"title": "String - Name of the variation bulk option",
"quantity": "Integer - Number of units in variation bulk option",
"price": {
"amount": "Float - Variation bulk option price amount",
"currency": "String - Variation bulk option price currency"
}
},
...
]
},
...
]
},
"coverage": {
"snippets": [
{
"text": "String - Coverage snippet text",
"link": "String - Coverage snippet link"
},
...
]
},
"shop_with_confidence": [
{
"type": "String - Internal eBay type of the `Shop with confidence` section (e.g. `authorized_seller`, `swc_top_rated_plus`)",
"title": "String - `Shop with confidence` section name (localized) (e.g. `Sony Authorized seller`, `Sony Vendedor autorizado`)",
"snippet_groups": [
[
{
"text": "String - Section snippet text",
"link": "String - Section snippet link"
},
...
],
...
]
},
...
],
"charity": {
"title": "String - Title of the charity block",
"snippets": [
{
"text": "String - Charity snippet text",
"link": "String - Charity snippet link"
},
...
],
"link": "String - Link to the charity page",
"image": {
"title": "String - Title of the charity image",
"link": "String - Charity image link"
}
},
"live_event": {
"link": "String - Link to Live event page"
"snippets": [
{
"text": "String - Live event snippet text",
"link": "String - Live event snippet link"
},
...
]
}
},
"seller_results": {
"type": "String - Type of the seller profile (`store`, `private`)",
"name": "String - Name of the seller",
"username": "String - Username of the seller profile",
"ssn": "String - Internal eBay SSN of the seller (sometimes used as a query param in the links)",
"bio": "String - Bio/description of the seller",
"joined_at": "String - Includes registration date of the seller (can be localized) (e.g. `Joined Nov 2011`, `eBay登録日：11 2011`)",
"response_time_hours": "Integer - Message response time of the seller (in hours)",
"sold_count": "Integer - Number of products sold",
"rating": "Integer - eBay rating of the seller",
"positive_feedback": "Float - Percentage of positive feedbacks about the seller",
"profile_link": "String - Link to the seller page",
"logo_link": "String - Link to the seller logo",
"catalog_link": "String - Link to the seller product catalog",
"popular_categories": {
"list": [
{
"title": "String - Title of the popular product category",
"link": "String - Link to the seller product catalog pre-filtered by the category",
"category_id": "String - eBay ID of the product category"
},
...
],
"see_all_link": "String - Link to the seller product catalog pre-filtered by all categories (excludes products without category)"
},
"rating_scores": [
{
"title": "String - Seller rating criterion",
"value": "Float - Criterion rating value (0.0-5.0)"
},
...
],
"reviews": {
"groups": {
"all_products": {
"count": "Integer - Number of seller reviews from all products",
"list": [
{
"review_id": "String - Unique eBay ID of the review",
"sentiment": "String - Sentiment of the review (`positive`, `negative`, `neutral`)",
"author": {
"username": "String - Username of the review author",
"rating": "Integer - eBay rating of the review author"
},
"text": "String - Text of the review",
"image_link": "String - Link to the image attached to the review",
"created_time": "String - General creation time of the review (e.g. `Past month`, `Past 6 months`)",
"product": {
"id": "String - Unique eBay ID of the reviewed product",
"link": "String - Link to the page of the reviewed product"
"title": "String - Title of the reviewed product"
},
"verified_purchase": "Boolean - Indicates whether purchase of the reviewed product is verified"
},
...
]
},
"this_product": {
"count": "Integer - Number of seller reviews from current product",
"list": [
{
"review_id": "String - Unique eBay ID of the review",
"sentiment": "String - Sentiment of the review (`positive`, `negative`, `neutral`)",
"author": {
"username": "String - Username of the review author",
"rating": "Integer - eBay rating of the review author"
},
"text": "String - Text of the review",
"image_link": "String - Link to the image attached to the review",
"created_time": "String - General creation time of the review (e.g. `Past month`, `Past 6 months`)",
"verified_purchase": "Boolean - Indicates whether purchase of the reviewed product is verified"
},
...
]
}
},
"see_all_link": "String - Link to the seller reviews page"
}
},
"related_products": [
{
"product_id": "String - Unique eBay ID of the related product",
"product_link": "String - Link to the page of the related product",
"title": "String - Title of the related product",
"price": {
"amount": "Float - Related product price amount",
"currency": "String - Related product price currency"
},
"image_link": "String - Link to the image of the related product",
"condition": "String - Condition of the related product",
"extensions": "Array[String] - Related product details",
"bold_extensions": "Array[String] - Related product details shown in bold style",
"strikethrough_extensions": "Array[String] - Related product details shown in strikethrough style",
"detected_extensions": {
"free_shipping": "Boolean - Indicates whether related product has free shipping",
"top_rated_plus": "Boolean - Indicates whether seller of the related product is Top Rated"
},
"signals": "Array[String] - Related product attention messages (e.g. `ALMOST GONE`, `LAST ONE`)"
},
...
]
...
}