Ebay Parser
Using the ScrapeOps Parser API you can scrape Ebay Pages without having to maintain your own product parsers.
Simply send the HTML of the Ebay Pages to the Parser API endpoint, and receive the data in structured JSON format.
Ebay Parser API Endpoint:
"https://parser.scrapeops.io/v2/ebay"
The Ebay Parser supports the following page types:
Authorisation - API Key
To use the ScrapeOps Parser API, you first need an API key which you can get by signing up for a free account here.
Your API key must be included with every request using the api_key
query parameter otherwise the API will return a 403 Forbidden Access
status code.
Ebay Product Page Parser
To use the Parser API without the ScrapeOps Proxy Aggregator, you first need to retrieve the HTML of the page you want to extract the data from.
For example, here we retrieve the HTML from the following Ebay Product Page with a very simple GET request:
import requests
response = requests.get('https://www.ebay.com/itm/376133027549')
if response.status_code == 200:
html = response.text
print(html)
Next, we send this HTML to the ScrapeOps Parser API for data extraction using a POST
request:
import requests
response = requests.get('https://www.ebay.com/itm/376133027549')
if response.status_code == 200:
html = response.text
data = {
'url': 'https://www.ebay.com/itm/376133027549',
'html': html,
}
response = requests.post(
url='https://parser.scrapeops.io/v2/ebay',
params={'api_key': 'YOUR_API_KEY'},
json=data
)
print(response.json())
The API will return a JSON response with the following data (status
, data
, url
):
{
"data": {
"name": "Rolex Daytona Cosmograph Two-Tone 18k Yellow Gold Steel CREAM 40mm 116523 Watch | eBay",
"product_details": {
"item_number": "296633631788",
"item_specifics": [
{
"label": "Condition",
"value": "Pre-owned: An item that has been used previously. The item may have some signs of cosmetic wear, but is fully operational and functions as intended. This item may be a floor model or store return that has been used. See the seller’s listing for full details and description of any imperfections."
},
{
"label": "Brand",
"value": "Rolex"
}
...
],
"revision_history": "Last updated on Aug 19, 2024 13:09:25 PDT",
"revision_history_link": "https://www.ebay.com/rvh/296633631788",
"seller_legal_text": "Seller assumes all responsibility for this listing."
},
"images": [
"https://i.ebayimg.com/thumbs/images/g/OrQAAOSwBPdmvmQr/s-l500.jpg",
"https://i.ebayimg.com/images/g/v0oAAOSwZGJmvmQs/s-l140.webp",
"https://i.ebayimg.com/images/g/R0EAAOSwEXVmvmQt/s-l140.webp",
"https://i.ebayimg.com/images/g/WJYAAOSwUg1mvmQu/s-l140.webp"
...
],
"product_summary": {
"condition": "Pre-owned",
"name": "Rolex Daytona Cosmograph Two-Tone 18k Yellow Gold Steel CREAM 40mm 116523 Watch",
"payments": [
"PayPal",
"Venmo",
"Google Pay",
"Visa",
"Master Card",
"Discover",
"Wire Transfer",
"eBay Mastercard"
],
"price_primary": "US $14,293.41",
"returns": "30 days returns . Buyer pays for return shipping . See details- for more information about returns",
"seller_image": "https://i.ebayimg.com/images/g/Zv8AAOSwsWpjPj1z/s-l64.jpg",
"seller_name": "Collectors Lynbrook New York",
"seller_url": "https://www.ebay.com/str/collectorschrono",
"shipping": [
"Free 2-4 day shipping",
"Get it between Sat, Aug 31 and Wed, Sep 4 to 90012 . See detailsfor shipping",
"Located in: Old Bridge, New Jersey, United States"
]
},
"related_categories": [
{
"text": "Rolex Cosmograph Daytona 116523",
"url": "https://www.ebay.com/b/Rolex-Cosmograph-Daytona-116523/31387/bn_7121881781"
},
{
"text": "Rolex Cosmograph Daytona Watches",
"url": "https://www.ebay.com/b/Rolex-Cosmograph-Daytona-Watches/31387/bn_2961223"
}
...
],
"related_searches": [
{
"text": "rolex daytona 18k",
"url": "https://www.ebay.com/shop/rolex-daytona-18k?_nkw=rolex+daytona+18k"
},
{
"text": "daytona rolex diamond",
"url": "https://www.ebay.com/shop/daytona-rolex-diamond?_nkw=daytona+rolex+diamond"
}
...
],
"reviews": {
"overall_rating": 5,
"rating_breakdown": {
"1": 0,
"2": 0,
"3": 0,
"4": 0,
"5": 1
},
"reviews": [
{
"condition": "Pre-Owned",
"content": "Great, thank you!Great, thank you!",
"date": "May 17, 2024",
"rating": 5,
"reviewer_name": "slat3r",
"sold_by": "techstore-001",
"title": "Great, thank you!",
"verified": true
}
],
"total_ratings": 1
},
"store_information": {
"feedback_info": {
"feedback_count": 3850,
"feedbacks": [
{
"comment": "Absolutely thrilled with my purchase of the Breitling Navitimer B01 from this seller! The watch arrived exactly as described, in pristine condition with all original paperwork and box. Shipping was incredibly fast, and the watch was securely packaged to avoid any damage. Communication from the seller was top-notch; they were very professional and responsive to all my inquiries. I highly recommend this seller for anyone looking to buy high-quality, authentic timepieces.",
"is_verified_purchase": true,
"product_name": "Breitling Navitimer B01 PAPERS Chronograph 43 Steel Black 43mm AB0121 Watch BOX (#305607093283)",
"product_url": "https://www.ebay.com/itm/305607093283",
"type": "positive",
"user": "p***u (10) "
},
{
"comment": "Fantastic experience with this seller! Great communication and the watch arrived exactly as described shown. Although the watch did not come with its original box, the one that was provided was really quite nice, which was a pleasant surprise and a nice touch. The only thing better than my experience with the seller is the watch itself!",
"is_verified_purchase": true,
"product_name": "Tag Heuer Carrera Date Calibre 5 Steel Silver 38mm Automatic WV211A-0 Watch (#296320396532)",
"product_url": "https://www.ebay.com/itm/296320396532",
"type": "positive",
"user": "5***e (47) "
},
{
"comment": "My first Rolex purchase.. had been waiting over a year and a half to get it from my local dealer. Decided to purchase online.. shopped for a few months and Collectors Lynbrook had the best product/price. Item exactly as described, seller shipped quickly, eBay authenticated quicky. Great communications. I would certainly buy from them again. Thank you!",
"is_verified_purchase": true,
"type": "positive",
"user": "n***b (248) "
}
],
"url": "https://www.ebay.com/fdbk/mweb_profile?fdbkType=FeedbackReceivedAsSeller&item_id=296633631788&username=collectorslynbrook&filter=feedback_page%3ARECEIVED_AS_SELLER&sort=RELEVANCE"
},
"items_sold": "8.1K",
"logo": "https://i.ebayimg.com/images/g/Zv8AAOSwsWpjPj1z/s-l140.jpg",
"name": "Collectors Lynbrook New York",
"popular_categories": [
{
"text": "Collectibles",
"url": "https://www.ebay.com/str/collectorschrono/Collectibles/_i.html?_sacat=1"
},
{
"text": "Jewelry &Watches",
"url": "https://www.ebay.com/str/collectorschrono/Jewelry-Watches/_i.html?_sacat=281"
}
...
],
"positive_feedback": "99.7%",
"properties": [
"Joined Mar 2002",
"Usually responds within 24 hours"
],
"url": "https://www.ebay.com/str/collectorschrono"
}
},
"status": "valid",
"url": "https://www.ebay.com/itm/376133027549"
}
A full example JSON response can be found here.
Ebay Search Page Parser
To use the Parser API without the ScrapeOps Proxy Aggregator, you first need to retrieve the HTML of the page you want to extract the data from.
For example, here we retrieve the HTML from the following Ebay Search Page with a very simple GET request:
import requests
response = requests.get('https://www.ebay.com/sch/i.html?_nkw=shoes')
if response.status_code == 200:
html = response.text
print(html)
Next, we send this HTML to the ScrapeOps Parser API for data extraction using a POST
request:
import requests
response = requests.get('https://www.ebay.com/sch/i.html?_nkw=shoes')
if response.status_code == 200:
html = response.text
data = {
'url': 'https://www.ebay.com/sch/i.html?_nkw=shoes',
'html': html,
}
response = requests.post(
url='https://parser.scrapeops.io/v2/ebay',
params={'api_key': 'YOUR_API_KEY'},
json=data
)
print(response.json())
The API will return a JSON response with the following data (status
, data
, url
):
{
"data": {
"ads": {
"products": [
{
"authorized_seller": "Direct from Puma",
"condition": "Brand New",
"image": "https://www.ebay.com./search_page_files/s-l500(24).webp",
"name": "PUMA Men's SOFTRIDE Symmetry Fuzion Running Shoes",
"price": "$70.00",
"shipping_options": "+$84.85 delivery",
"url": "https://www.ebay.com/itm/277003406603?_skw=shoes&epid=12072849425&itmmeta=01JSE6T7MYXXJZZMSC67N7CCWB&hash=item407eb08d0b:g:BtMAAeSwXJtn7slk&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1fXlITxUQqRDcyhtQy379strHghT63aBmk3uXjjWH7oT8pLUTZxnWyzOwySV%2BeZhV6ppHUGloFWissG9Kn1bjm6Z9J%2BBfmvMKPwyoxKyrFPXgrKvBr8xM6G4hmTHD9kvchKN3rAd%2FnDXHiXRS2R1mhlqQXplPDPk5fszYG7rZkXXU5iq44jFqZDc1iW7ZOL4dlIiVPuCFXE7NWz%2Fgfv3aZNSVtSn24thYgI2V%2F72soEO380SOT74tT93ZcSmxSFDjHK5V6MuqCbJ5ZFsnc464zE%7Ctkp%3ABFBM-vroxstl"
},
{
"condition": "Brand New",
"image": "https://www.ebay.com./search_page_files/s-l500(25).webp",
"name": "Nike Air Max 2017 Triple Black Mens Sneakers Size US 7-15 Casual Shoes New✅",
"price": "$96.23",
"shipping_options": "+$19.25 delivery",
"url": "https://www.ebay.com/itm/224957225546?_skw=shoes&epid=8047598199&itmmeta=01JSE6T7MYQZA1CYK9HDG5XX02&hash=item34607eda4a:g:0w8AAOSw5VFnyu28&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1eBbrXPUhfoTM2OIQQJJQ7KafOktMjKItMGBexGn9XGdGsB3Z5B8QDJFcHeouqOurjlJ2wKk5KuOI4Jm%2FWY2th5P50IVOzQ3XYUYNB54eNGvtg%2Fea3%2FKeRopvIbdj61kEhiEZ4%2FtwtfQRpeLIV6TjHrVq3LlVidRZgQg5ucP%2BArFKcf5XTidS1AlnnwTXnJdJKjaQpsaIHu%2BJzWckpccD%2FzQZCpj3YPNz7xFSYlrOYnDGgPsD8H%2FHhPRgLdqKOj8KFSH9iSTPTS%2BhTqx57VW9Pt%7Ctkp%3ABFBM-vroxstl"
}
...
],
"subtitle": "Sponsored | Top selling items from highly rated sellers with free shipping",
"title": "Picked For You"
},
"related_searches": [
{
"link": "https://www.ebay.com/sch/i.html?_nkw=shoes+men&_sop=12",
"query": "shoes men"
},
{
"link": "https://www.ebay.com/sch/i.html?_nkw=jordans&_sop=12",
"query": "jordans"
}
...
],
"search_information": {
"query": "shoes",
"shipping_to": "90012",
"total_count": 8000000,
"total_count_displayed": "8,000,000 + results for shoes"
},
"search_pagination": [
{
"current": true,
"number": 1,
"url": "https://www.ebay.com/sch/i.html?_nkw=shoes&_pgn=1"
},
{
"number": 2,
"url": "https://www.ebay.com/sch/i.html?_nkw=shoes&_pgn=2"
}
...
],
"search_results": [
{
"condition": "Brand New",
"image": "https://i.ebayimg.com/images/g/i5IAAOSwJYhjzu-n/s-l500.webp",
"name": "Nike Dunk Low Panda Black White Size 7 to 13 Mens Womens Grade School New",
"price": "$124.99",
"rating": 4.5,
"review_count": 8,
"shipping_options": "+$14.95 shipping",
"url": "https://www.ebay.com/itm/325509566046?_nkw=shoes&var=514946544566&epid=9058284114&itmmeta=01J6E19BDJNVZHB8ASBYZ8SH4Q&hash=item4bc9e1ce5e:g:i5IAAOSwJYhjzu-n&itmprp=enc%3AAQAJAAAAwHoV3kP08IDx%2BKZ9MfhVJKlnQipUtXNoOqmIawDF67R1Lf20GS0kw0uDNgrPKVvu2uYnF%2FuSM%2BNPM3MD7D4hrIFV%2FQBe9fRqmc2lCP6%2BK7lwGWPu8pOUAD5yqV67af4H8N9nu%2FW9NCT%2BWJ7WO2ai%2F%2BXeXCN8in3TYoWcQ4BuPfWgwRGoHS05kt2TDu5hWavaB56FEYmzg8ElftcMAvLziSsSWjV4I4E67oELUIEPjTeUtRlGg86oHugkYhlTYKPngA%3D%3D%7Ctkp%3ABlBMUPy2pcGzZA"
},
{
"condition": "Pre-Owned",
"image": "https://i.ebayimg.com/images/g/zlMAAOSwuKVjDoeC/s-l500.webp",
"name": "Dr Martens UK 5 US 6 Women 8 Brown Leather England Chunky Shoe Ankle Boot",
"price": "$39.00",
"price_additional": "Was: $60.00",
"price_discount": "35% off",
"return_options": "Free returns",
"shipping_options": "+$20.50 shipping",
"url": "https://www.ebay.com/itm/195899103108?_nkw=shoes&itmmeta=01J6E19BDJ1C46NMH2Z8BRST5F&hash=item2d9c7f1784:g:zlMAAOSwuKVjDoeC&itmprp=enc%3AAQAJAAAAwHoV3kP08IDx%2BKZ9MfhVJKmQ4KHONxsxgDyvQHtQkzNgmIqv%2BeqBBLCjGVWGzjg1fKBVDnQJhV4pkXXqkYJB2vlwEA36mRgHAXW952rxb3nsU6DcpQG7QQZK2fwGCTF0QndNPgfF4LrntSao%2FsDLklLUdGm5w%2BuZo2xxrvGWCsfs%2FRG7ZKiLoPWGE%2FP8k7yDNbw6GBvHKZEC%2BLwfr%2BlLg8d67q4eVLk%2B%2BJfqnJ8J%2BjqFlWvVcpki9eN%2FZENsGXM62Q%3D%3D%7Ctkp%3ABlBMUPy2pcGzZA"
},
{
"condition": "Pre-Owned · Nike",
"image": "https://i.ebayimg.com/images/g/Lw4AAOSwAbtl1Wsf/s-l140.webp",
"name": "Size 10.5 - Nike Zoom Freak 1 Oreo 2020",
"price": "$65.99",
"rating": 5,
"review_count": 2,
"shipping_options": "+$15.42 shipping",
"url": "https://www.ebay.com/itm/204670637800?_nkw=shoes&epid=17039825392&itmmeta=01J6E19BDJ4FX2FNM0TX1HTZZM&hash=item2fa75216e8:g:Lw4AAOSwAbtl1Wsf&itmprp=enc%3AAQAJAAAAwHoV3kP08IDx%2BKZ9MfhVJKnm8xzFYztyxXzuJnVfnm7zpblq8WfmR0%2FxUB%2BdIz106rHASzHDDypmm422C0HZ4tUFu4N%2FK3a%2FE5q6YjcGu5u2JVkqKyembJM%2Bukk4spc6jSAJEM%2BJ%2BFVT6bi2RosPIDUs4mkONbiTE%2BkKC8mTssge2ME0qf4DHu%2B0Ua1pPgCfQksa1tSeCTu9SabV%2Fu--F78sLj1qCDNb3IxBLDCC5SbfbpgBn%2FGDFLQzxEP3QbNInA%3D%3D%7Ctkp%3ABlBMUPy2pcGzZA"
}
...
]
},
"status": "valid",
"url": "https://www.ebay.com/sch/i.html?_nkw=shoes&_sop=12&_kwlnd=1"
}
A full example JSON response can be found here.
Ebay Category Page Parser
To use the Parser API without the ScrapeOps Proxy Aggregator, you first need to retrieve the HTML of the page you want to extract the data from.
For example, here we retrieve the HTML from the following Ebay Category Page with a very simple GET request:
import requests
response = requests.get('https://www.ebay.com/b/Headphones/112529/bn_879608')
if response.status_code == 200:
html = response.text
print(html)
Next, we send this HTML to the ScrapeOps Parser API for data extraction using a POST
request:
import requests
response = requests.get('https://www.ebay.com/b/Headphones/112529/bn_879608')
if response.status_code == 200:
html = response.text
data = {
'url': 'https://www.ebay.com/b/Headphones/112529/bn_879608',
'html': html,
}
response = requests.post(
url='https://parser.scrapeops.io/v2/ebay',
params={'api_key': 'YOUR_API_KEY'},
json=data
)
print(response.json())
The API will return a JSON response with the following data (status
, data
, url
):
{
"data": {
"brands": [
"Bose",
"Beats by Dr. Dre",
"JBL",
"Sony",
"Skullcandy",
"Sennheiser",
"Apple",
"AfterShokz",
"AKG",
"Jabra",
"Audio-Technica",
"Unbranded",
"USB-C",
"USB",
"Lightning",
"Micro-USB"
],
"categories": [
{
"name": "eBay",
"url": "https://www.ebay.com/"
},
{
"name": "Electronics",
"url": "https://www.ebay.com/b/Electronics/bn_7000259124"
},
{
"name": "Portable Audio & Headphones",
"url": "https://www.ebay.com/b/Portable-Audio-Headphones/15052/bn_1642614"
},
...
],
"name": "Headphones",
"related_categories": {
"categories": [
{
"image": "https://www.ebay.com./category_page_files/s_1x2.gif",
"name": "Beats by Dre Headphones",
"url": "https://www.ebay.com/b/Beats-by-Dre-Headphones/112529/bn_880687"
},
{
"image": "https://www.ebay.com./category_page_files/s_1x2.gif",
"name": "Bluedio Cell Phone Accessories",
"url": "https://www.ebay.com/b/Bluedio-Cell-Phone-Accessories/9394/bn_321322"
},
{
"image": "https://www.ebay.com./category_page_files/s_1x2.gif",
"name": "Noise Cancellation Headphones",
"url": "https://www.ebay.com/b/Noise-Cancellation-Headphones/112529/bn_884187"
},
...
],
"heading": "You May Also Like"
},
"search_results": {
"pagination": [
{
"number": "1",
"url": "https://www.ebay.com/b/Headphones/112529/bn_879608"
},
{
"number": "2",
"url": "https://www.ebay.com/b/Headphones/112529/bn_879608?_pgn=2&rt=nc"
},
{
"number": "3",
"url": "https://www.ebay.com/b/Headphones/112529/bn_879608?_pgn=3&rt=nc"
},
...
],
"products": [
{
"condition": "Brand New · Beats by Dr. Dre",
"hotness": "22 sold",
"image": "https://www.ebay.com./category_page_files/s-l960.webp",
"name": "Beats Studio Pro Wireless Bluetooth Noise Cancelling Headphones",
"price": "$149.95",
"price_prev": "Was: $161.27was - US $161.27",
"shipping_options": "Free shipping",
"url": "https://www.ebay.com/itm/365472312003?itmmeta=01JSE7BPDJ6V39SVJSJ7VGPQYG&hash=item5517d8eac3:g:H7wAAOSwWQpn3Em3&itmprp=enc%3AAQAKAAAA4MHg7L1Zz0LA5DYYmRTS30nmf3Tf8PdamtSzHNSn%2FAbw1%2BaOKonb8euFSnbCohS4MQq3Ortbk6F1jEYVShPLXAyR8JOOqQ7%2ByTV2maq%2BTLW1FYErfi%2Boi1IYdmgmV0oLuwV7GSuhOuLArd84yUkEXjVNCaFDxNV%2F%2Bpa4GRc4xFpRmdGcyT5etok8Un8aF4snDW6fEPheCvp9K3XrgOzDbZ5LE%2BB89RYqJpXA2685nOT9p7wY7%2FAUuRZN%2BNlBA9aT3IAC%2BFp247s0EdxpwQ5C%2Beelg%2Btfuji9Zor9u%2FjdeT8a%7Ctkp%3ABFBM8Oaux8tl&var=635277660029"
},
{
"condition": "New (Other) · Bose",
"image": "https://www.ebay.com./category_page_files/s-l960(1).webp",
"name": "Bose QuietComfort QC 35 / QC 35 II / QC 45 / NC 700 Noise Cancelling Headphones",
"price": "$129.99 to $199.99",
"shipping_options": "Free shipping",
"url": "https://www.ebay.com/itm/256791040295?itmmeta=01JSE7BPDJJRY5D2768QD6C5DH&hash=item3bc9f05127:g:YFYAAOSwLxJml5W~&itmprp=enc%3AAQAKAAAA4MHg7L1Zz0LA5DYYmRTS30kCJIth31j9zDIpMXbELpB4fAOoyBm09XAn5ub6L1akOOl0tVs%2F5wA0m2lxDePlZMRoyK3JKgWluRmJ8YqBwPU7zw9xTjUupXEhU4ovBQqIOY7ramejg%2FtEZcGVn4puSRi7VvdXgW3tqEPM8oMUASufFNd%2Bn1cDJCIxO3NbrJWvdQAJWhrnPB7EZpXp0gc0wJDQ6xkUU%2FWTGh53BN2UL66PC%2BmBHkSFp9RFXv1NK2VImXxiCKTRQdTj%2BqquxelzeYu%2FFhKVmXA6RKNswbFbXkcN%7Ctkp%3ABFBM8Oaux8tl&var=557275009047"
},
{
"condition": "Brand New · Apple",
"image": "https://www.ebay.com./category_page_files/s-l960(2).webp",
"name": "New ListingAirPod Max",
"price": "$200.00",
"purchase_options": "or Best Offer",
"url": "https://www.ebay.com/itm/376188917772?itmmeta=01JSE7BPDJVP2JW5W7G9F4MWZX&hash=item57969b580c:g:5lkAAeSw8IxoBk8i&itmprp=enc%3AAQAKAAAA4MHg7L1Zz0LA5DYYmRTS30k8cE67Qbj2dR9%2Ft%2Fus9fKM8GfaU9t9mGznwMZ0fqArG0zcb5yeSmyGSxTs4iJyfMB%2BRnZXjDBh7jdlKuPGHmKkcWk68kwb6C%2F38OPyI%2FQg7rkMoedYsarGPTIesXd9fWvBB9dcTu%2BToy2ukklOwCDuq7kOnZq%2Fx6hjjBpNOQ4BgoGHCehzlVqelcHPV3z9sYG4W5zcDb8R9CfYLdZnzdvDO4KZd34PhpsLlKXP%2BLpNLK2QVhbkZNmQhxHRI%2FPQ5HnW68zVUm%2B%2F2Tqy0HZ%2F3yHR%7Ctkp%3ABFBM8Oaux8tl"
},
...
],
"total_count": 250814
},
"side_navigation": {
"menus": [
{
"text": "Portable Audio & Headphones",
"url": "https://www.ebay.com/b/Portable-Audio-Headphones/15052/bn_1642614"
},
{
"text": "Audio Docks & Mini Speakers",
"url": "https://www.ebay.com/b/Audio-Player-Docks-Mini-Speakers/111694/bn_879606"
},
{
"text": "Headphone Accessories",
"url": "https://www.ebay.com/b/Headphone-Accessories/260318/bn_7116422304"
},
...
],
"title": "Shop by Category"
},
"top_products": [
{
"heading": "Best Selling",
"products": [
{
"image": "https://www.ebay.com./category_page_files/s_1x2.gif",
"name": "Bose QuietComfort Earbuds - Black (882826-0010)",
"price_new": "$184.85 New",
"price_used": "$99.50 Used",
"rating_count": 36,
"rating_star": 4.7,
"url": "https://www.ebay.com/p/18063094354?iid=156796111317"
},
{
"image": "https://www.ebay.com./category_page_files/s_1x2.gif",
"name": "Sony WH-1000XM5 Wireless Noise Canceling Headphones - Black",
"price_new": "$14.95 New",
"price_used": "$9.95 Used",
"rating_count": 213,
"rating_star": 4.8,
"url": "https://www.ebay.com/p/22054478105?iid=115790273100"
},
{
"image": "https://www.ebay.com./category_page_files/s_1x2.gif",
"name": "Beats by Dr. Dre Powerbeats Pro In Ear Wireless Headphones - Black",
"price_new": "$112.00 New",
"price_used": "$7.99 Used",
"rating_count": 966,
"rating_star": 4.6,
"url": "https://www.ebay.com/p/17042189888?iid=286076708566"
},
...
]
}
]
},
"status": "valid",
"url": "https://www.ebay.com/b/Headphones/112529/bn_879608"
}
A full example JSON response can be found here.
Ebay Store Page Parser
To use the Parser API without the ScrapeOps Proxy Aggregator, you first need to retrieve the HTML of the page you want to extract the data from.
For example, here we retrieve the HTML from the following Ebay Store Page with a very simple GET request:
import requests
response = requests.get('https://www.ebay.com/str/lindasstuff')
if response.status_code == 200:
html = response.text
print(html)
Next, we send this HTML to the ScrapeOps Parser API for data extraction using a POST
request:
import requests
response = requests.get('https://www.ebay.com/str/lindasstuff')
if response.status_code == 200:
html = response.text
data = {
'url': 'https://www.ebay.com/str/lindasstuff',
'html': html,
}
response = requests.post(
url='https://parser.scrapeops.io/v2/ebay',
params={'api_key': 'YOUR_API_KEY'},
json=data
)
print(response.json())
The API will return a JSON response with the following data (status
, data
, url
):
{
"data": {
"about_us": {
"description": "As one of the largest sellers of fashion apparel &accessories on eBay, Linda’s Stuff offers a coveted collection of designer goods that is second to none. Give us a call and start consigning today: 866-68-LINDA. We make the process easy &seamless, and you can earn up to 80% of each item sold! When shopping with us, you can expect prices up to 90% off retail, personal customer service, and 100% authentic goods! With daily consignment shipments, there are always new, rare, vintage, &fashionable finds for you to discover brands ranging from Chanel to Lululemon. Buy &sell designer styles with us for an unmatched consignment experience!",
"location": "United States",
"member_since": "Apr 11, 2001",
"name": "linda*s***stuff",
"top_rated_seller": true,
"top_rated_summary": "Linda's Stuff is one of eBay's most reputable sellers. Consistently delivers outstanding customer service"
},
"feedback_info": {
"feedback_count": 1391729,
"feedbacks": [
{
"comment": "Item as described and pictured in the listing; packaged well for shipment and arrived in excellent NWOT condition; seller addressed all my post-sale questions in a timely and pleasant manner; quality matches the price point -- great value at the bargain price vs retail; my niece loved them but sadly had to return- they seemed to run small",
"time": "Past 6 months",
"type": "positive",
"user_feedbacks": 1383,
"user_name": "m***r",
"verified_purchase": true
},
{
"comment": "Item as described and pictured in the listing; packaged well for shipment and arrived in NWT condition; seller addressed all my pre-sale questions in a timely and pleasant manner; quality matches the price point -- great value at the bargain price vs retail; my niece loved them but they seemed to run small--had to return.",
"time": "Past 6 months",
"type": "positive",
"user_feedbacks": 1383,
"user_name": "m***r",
"verified_purchase": true
}
...
],
"overall_ratings": [
{
"count": 52411,
"label": "Positive",
"link": "https://www.ebay.com/fdbk/feedback_profile/linda*s***stuff?filter=feedback_page%3ARECEIVED_AS_SELLER%2Cperiod%3ATWELVE_MONTHS%2Coverall_rating%3APOSITIVE&commentType=POSITIVE_sp=p3418065.m133622.l9215"
},
{
"count": 673,
"label": "Neutral",
"link": "https://www.ebay.com/fdbk/feedback_profile/linda*s***stuff?filter=feedback_page%3ARECEIVED_AS_SELLER%2Cperiod%3ATWELVE_MONTHS%2Coverall_rating%3ANEUTRAL&commentType=NEUTRAL_sp=p3418065.m133622.l9215"
},
{
"count": 328,
"label": "Negative",
"link": "https://www.ebay.com/fdbk/feedback_profile/linda*s***stuff?filter=feedback_page%3ARECEIVED_AS_SELLER%2Cperiod%3ATWELVE_MONTHS%2Coverall_rating%3ANEGATIVE&commentType=NEGATIVE_sp=p3418065.m133622.l9215"
}
],
"seller_ratings": [
{
"label": "Accurate description",
"rating": 4.9
},
{
"label": "Reasonable shipping cost",
"rating": 4.9
},
{
"label": "Shipping speed",
"rating": 5
},
{
"label": "Communication",
"rating": 5
}
],
"url": "https://www.ebay.com/fdbk/feedback_profile/linda*s***stuff?filter=feedback_page%3ARECEIVED_AS_SELLER&sort=RELEVANCEdata-ebayuidata-test-id=fdbk-detail-list__btn-container__btndata-track='{\"actionKind\":\"NAV\",\"operationId\":\"3418065\",\"flushImmediately\":false,\"eventProperty\":{\"sid\":\"p3418065.m133622.l9215\"}}'"
},
"sale_info": [
{
"products": [
{
"image": "https://i.ebayimg.com/thumbs/images/g/u4YAAOSwYDtmtQtY/s-l500.jpg",
"name": "Prada Womens Black Leather Puffer Flap Zip Detail Shoulder Bag Handbag",
"price": "$469.99",
"price_discount": "6% off",
"price_previous": "$499.99",
"url": "https://www.ebay.com/itm/204876060439?_trkparms=amclksrc%3DITM%26aid%3D111001%26algo%3DREC.SEED%26ao%3D1%26asc%3D20231211145321%26meid%3D0d277d7b5b8649b1ad7539de0c761666%26pid%3D101927%26rk%3D1%26rkt%3D5%26sd%3D204876060439%26itm%3D204876060439%26pmt%3D1%26noa%3D1%26pg%3D3671980%26brand%3DPRADA&_trksid=p3671980.c101927.m1234data-track='[{\"actionKind\":\"NAV\",\"operationId\":\"3418065\",\"flushImmediately\":false,\"eventProperty\":{\"parentrq\":\"9f4137341910a5172b804789fffdf408\",\"amdata\":\"amclksrc%3DITM%26aid%3D111001%26algo%3DREC.SEED%26ao%3D1%26asc%3D20231211145321%26meid%3D0d277d7b5b8649b1ad7539de0c761666%26pid%3D101927%26rk%3D1%26rkt%3D5%26sd%3D204876060439%26itm%3D204876060439%26pmt%3D1%26noa%3D1%26pg%3D3671980%26brand%3DPRADA%26tu%3D01J6FM2E5EFZ7GFFPGCJ11ACFN\",\"ampid\":\"MERCH_CLK\",\"ammiid\":\"0d277d7b5b8649b1ad7539de0c761666\",\"sid\":\"p3418065.m1234.c20231211145321\"}}]'target=_blank_sp=p3418065.m1234.c20231211145321"
},
{
"image": "https://i.ebayimg.com/thumbs/images/g/g1kAAOSwYEtmgnyF/s-l500.jpg",
"name": "Prada Womens Nylon Silver Tone Hardware Drawstring Pouch Bag Navy Blue Handbag",
"price": "$414.55",
"price_discount": "6% off",
"price_previous": "$441.01",
"url": "https://www.ebay.com/itm/315498214998?_trkparms=amclksrc%3DITM%26aid%3D111001%26algo%3DREC.SEED%26ao%3D1%26asc%3D20231211145321%26meid%3D0d277d7b5b8649b1ad7539de0c761666%26pid%3D101927%26rk%3D2%26rkt%3D5%26sd%3D204876060439%26itm%3D315498214998%26pmt%3D1%26noa%3D1%26pg%3D3671980%26brand%3DPRADA&_trksid=p3671980.c101927.m1234data-track='[{\"actionKind\":\"NAV\",\"operationId\":\"3418065\",\"flushImmediately\":false,\"eventProperty\":{\"parentrq\":\"9f4137341910a5172b804789fffdf408\",\"amdata\":\"amclksrc%3DITM%26aid%3D111001%26algo%3DREC.SEED%26ao%3D1%26asc%3D20231211145321%26meid%3D0d277d7b5b8649b1ad7539de0c761666%26pid%3D101927%26rk%3D2%26rkt%3D5%26sd%3D204876060439%26itm%3D315498214998%26pmt%3D1%26noa%3D1%26pg%3D3671980%26brand%3DPRADA%26tu%3D01J6FM2E5FERVSR0W63RE4X2ZG\",\"ampid\":\"MERCH_CLK\",\"ammiid\":\"0d277d7b5b8649b1ad7539de0c761666\",\"sid\":\"p3418065.m1234.c20231211145321\"}}]'target=_blank_sp=p3418065.m1234.c20231211145321"
}
...
],
"subtitle": "Marked down item price reflects all savings. Items provided by linda*s***stuff",
"title": "Save up to 8%"
},
{
"products": [
{
"image": "https://i.ebayimg.com/thumbs/images/g/f5UAAOSwxn9mtQuV/s-l500.jpg",
"name": "Hermes Womens Vert Anis Green Gold Hardware Togo Leather 35 cm Birkin Handbag",
"price": "$15,299.99",
"price_discount": "10% off",
"price_previous": "$16,999.99",
"url": "https://www.ebay.com/itm/204882933993?_trkparms=amclksrc%3DITM%26aid%3D111001%26algo%3DREC.SEED%26ao%3D1%26asc%3D20231211145321%26meid%3D45b6f050e57a474594062085337d1980%26pid%3D101927%26rk%3D1%26rkt%3D3%26sd%3D204882933993%26itm%3D204882933993%26pmt%3D1%26noa%3D1%26pg%3D3671980%26brand%3DHERM%25C8S&_trksid=p3671980.c101927.m1234data-track='[{\"actionKind\":\"NAV\",\"operationId\":\"3418065\",\"flushImmediately\":false,\"eventProperty\":{\"parentrq\":\"9f4137341910a5172b804789fffdf408\",\"amdata\":\"amclksrc%3DITM%26aid%3D111001%26algo%3DREC.SEED%26ao%3D1%26asc%3D20231211145321%26meid%3D45b6f050e57a474594062085337d1980%26pid%3D101927%26rk%3D1%26rkt%3D3%26sd%3D204882933993%26itm%3D204882933993%26pmt%3D1%26noa%3D1%26pg%3D3671980%26brand%3DHERM%25C8S%26tu%3D01J6FM2E586QRH8HN0FN5KCYAX\",\"ampid\":\"MERCH_CLK\",\"ammiid\":\"45b6f050e57a474594062085337d1980\",\"sid\":\"p3418065.m1234.c20231211145321\"}}]'target=_blank_sp=p3418065.m1234.c20231211145321"
},
{
"image": "https://i.ebayimg.com/thumbs/images/g/vBsAAOSwQGVmtQ0F/s-l500.jpg",
"name": "Hermes Womens Toile Togo Sellier 28 Ecru Beige Vintage Handbag Brown Beige",
"price": "$9,899.99",
"price_discount": "10% off",
"price_previous": "$10,999.99",
"url": "https://www.ebay.com/itm/315566446947?_trkparms=amclksrc%3DITM%26aid%3D111001%26algo%3DREC.SEED%26ao%3D1%26asc%3D20231211145321%26meid%3D45b6f050e57a474594062085337d1980%26pid%3D101927%26rk%3D2%26rkt%3D3%26sd%3D204882933993%26itm%3D315566446947%26pmt%3D1%26noa%3D1%26pg%3D3671980%26brand%3DHERM%25C8S&_trksid=p3671980.c101927.m1234data-track='[{\"actionKind\":\"NAV\",\"operationId\":\"3418065\",\"flushImmediately\":false,\"eventProperty\":{\"parentrq\":\"9f4137341910a5172b804789fffdf408\",\"amdata\":\"amclksrc%3DITM%26aid%3D111001%26algo%3DREC.SEED%26ao%3D1%26asc%3D20231211145321%26meid%3D45b6f050e57a474594062085337d1980%26pid%3D101927%26rk%3D2%26rkt%3D3%26sd%3D204882933993%26itm%3D315566446947%26pmt%3D1%26noa%3D1%26pg%3D3671980%26brand%3DHERM%25C8S%26tu%3D01J6FM2E59TWC6RKWVEDDF0CNY\",\"ampid\":\"MERCH_CLK\",\"ammiid\":\"45b6f050e57a474594062085337d1980\",\"sid\":\"p3418065.m1234.c20231211145321\"}}]'target=_blank_sp=p3418065.m1234.c20231211145321"
}
...
],
"subtitle": "Marked down item price reflects all savings. Items provided by linda*s***stuff",
"title": "Save up to 10%"
}
...
],
"seller": {
"followers": "135K",
"items_sold": "4.2M",
"logo": "https://i.ebayimg.com/images/g/Br0AAOSw0xhg5ayB/s-l140.webp",
"name": "Linda's Stuff",
"positive_feedback": "99.2%"
},
"shop_info": {
"ads": [
{
"heading": "Auctions ending soon",
"items": [
{
"bid_count": 0,
"image": "https://i.ebayimg.com/images/g/uOEAAOSwR7dmzgRV/s-l300.webp",
"name": "Fifteen Twenty Womens Faux Suede High Waist Leggings Grey Size Medium 11325982",
"price": "$19.99",
"url": "https://www.ebay.com/itm/315692135550"
},
{
"bid_count": 0,
"image": "https://i.ebayimg.com/images/g/ls8AAOSwOWtmzJiY/s-l300.webp",
"name": "Bottega Veneta Womens Single Handle Zip Top Double Knot Handbag Green Leather",
"price": "$1,780.00",
"url": "https://www.ebay.com/itm/315692135551"
}
...
]
},
{
"heading": "Best Sellers",
"items": [
{
"image": "https://i.ebayimg.com/images/g/PuYAAOSwfABml5Sr/s-l300.webp",
"name": "Everlane Womens Rubber Rain Boots Tan 8",
"price": "$42.99",
"url": "https://www.ebay.com/itm/315563215001"
}
]
}
],
"products": {
"more": "https://www.ebay.com/sch/i.html?_dkr=1&iconV2Request=true&_blrs=recall_filtering&_ssn=linda*s***stuff&store_name=lindasstuff&_oac=1data-ebayuidata-track='{\"eventFamily\":\"STOREFRONT\",\"eventAction\":\"ACTN\",\"actionKind\":\"CLICK\",\"operationId\":\"3418065\",\"flushImmediately\":false,\"eventProperty\":{\"str\":\"lindasstuff\",\"soid\":\"KQCKHjrkToa\",\"ads-soid\":\"30121573\",\"moduledtl\":\"59799\",\"spid\":\"KQCKHjrkToa\",\"sid\":\"p3418065.m59799.l117658\"}}'",
"products": [
{
"image": "https://i.ebayimg.com/images/g/nU8AAOSwGzxm0EMl/s-l300.webp",
"name": "Mate Womens Cotton Terry Eat Plants Crewneck Sweatshirt Cream White Size XL",
"price": "$44.99",
"price_additional": "List price: $132.00",
"price_discount": "66% off",
"url": "https://www.ebay.com/itm/204965725020"
},
{
"bid_count": 0,
"image": "https://i.ebayimg.com/images/g/l~UAAOSw2~Zmz7Jz/s-l300.webp",
"name": "Gucci Mens White Striped Low Top Lace Up Fashion Sneaker Shoes Size 7.5 LL19LL",
"price": "$19.99",
"url": "https://www.ebay.com/itm/387338131927"
}
...
],
"title": "All items"
}
}
},
"status": "valid",
"url": "https://www.ebay.com/str/lindasstuff"
}
A full example JSON response can be found here.
Ebay Feedback Page Parser
To use the Parser API without the ScrapeOps Proxy Aggregator, you first need to retrieve the HTML of the page you want to extract the data from.
For example, here we retrieve the HTML from the following Ebay Feedback Page with a very simple GET request:
import requests
response = requests.get('https://www.ebay.com/fdbk/mweb_profile?item_id=296633631788&username=collectorslynbrook')
if response.status_code == 200:
html = response.text
print(html)
Next, we send this HTML to the ScrapeOps Parser API for data extraction using a POST
request:
import requests
response = requests.get('https://www.ebay.com/fdbk/mweb_profile?item_id=296633631788&username=collectorslynbrook')
if response.status_code == 200:
html = response.text
data = {
'url': 'https://www.ebay.com/fdbk/mweb_profile?item_id=296633631788&username=collectorslynbrook',
'html': html,
}
response = requests.post(
url='https://parser.scrapeops.io/v2/ebay',
params={'api_key': 'YOUR_API_KEY'},
json=data
)
print(response.json())
The API will return a JSON response with the following data (status
, data
, url
):
{
"data": {
"details": {
"feedback_revised": "7",
"feedback_total": "4,787",
"feedbacks": [
{
"comment": "Absolutely thrilled with my purchase of the Breitling Navitimer B01 from this seller! The watch arrived exactly as described, in pristine condition with all original paperwork and box. Shipping was incredibly fast, and the watch was securely packaged to avoid any damage. Communication from the seller was top-notch; they were very professional and responsive to all my inquiries. I highly recommend this seller for anyone looking to buy high-quality, authentic timepieces.",
"item_id": "305607093283",
"item_link": "https://www.ebay.com/itm/305607093283data-test-id=fdbk-item-1",
"item_name": "Breitling Navitimer B01 PAPERS Chronograph 43 Steel Black 43mm AB0121 Watch BOX",
"price": "US $4,010.00",
"rating": "positive",
"user": "p***u",
"user_score": 8,
"user_type": "buyer",
"when": "Past month"
},
{
"comment": "Fantastic experience with this seller! Great communication and the watch arrived exactly as described shown. Although the watch did not come with its original box, the one that was provided was really quite nice, which was a pleasant surprise and a nice touch. The only thing better than my experience with the seller is the watch itself!",
"item_id": "296320396532",
"item_link": "https://www.ebay.com/itm/296320396532data-test-id=fdbk-item-2",
"item_name": "Tag Heuer Carrera Date Calibre 5 Steel Silver 38mm Automatic WV211A-0 Watch",
"price": "US $1,050.00",
"rating": "positive",
"user": "5***e",
"user_score": 47,
"user_type": "buyer",
"when": "Past 6 months"
}
...
],
"filters": {
"period": "All",
"search": "",
"sort_by": "Most relevant"
},
"label": "All received Feedback",
"pagination": {
"page_count": 68,
"page_number": 1,
"page_size": 25
}
},
"member": {
"feedback_score": "4364",
"image": "https://i.ebayimg.com/00/s/MTM3WDE1MA==",
"location": "United States",
"member_since": "Mar-05-02",
"positive_feedback": "99.7%"
},
"rating": {
"feedback_ratings": [
{
"label": "1 month",
"negative": 0,
"neutral": 1,
"positive": 30
},
{
"label": "6 months",
"negative": 0,
"neutral": 1,
"positive": 213
},
{
"label": "12 months",
"negative": 1,
"neutral": 3,
"positive": 343
}
],
"seller_ratings": {
"ratings": [
{
"label": "Accurate description",
"rating_count": 232,
"rating_star": 4.9
},
{
"label": "Reasonable shipping cost",
"rating_count": 242,
"rating_star": 5
},
{
"label": "Shipping speed",
"rating_count": 239,
"rating_star": 5
},
{
"label": "Communication",
"rating_count": 231,
"rating_star": 4.9
}
],
"title": "Average for the last 12 months"
}
}
},
"status": "valid",
"url": ""
}
A full example JSON response can be found here.
Proxy API Integration
The ScrapeOps Parser API is integrated into the ScrapeOps Proxy API Aggregator and can be used for free by using the Auto Extract functionality.
So if you already have a Proxy API Aggregator plan then use the Parser API for no extra charge.
The following example shows you how to use the Parser API via a Python Requests based scraper using the Proxy API Aggregator:
import requests
response = requests.get(
url='https://proxy.scrapeops.io/v2/',
params={
'api_key': 'YOUR_API_KEY',
'url': 'https://www.ebay.com/itm/376133027549',
'auto_extract': 'ebay'
}
)
print(response.json())