Logo SearchApi

eBay Product API Documentation

The eBay Product API allows you to retrieve details, images, prices, shipping, and more for an eBay item or product. It uses /api/v1/search?engine=ebay_product API endpoint to scrape real-time results.

API Parameters

Search Query

  • Name
    item_id
    Required
    Required
    Description

    This parameter specifies the id of the eBay Item you want to retrieve data for. It is optional when product_id is present.

    An item in eBay is a live listing (one seller’s offer) identified by an item_id. If the listing has ended or the item is no longer available, the request may automatically fall back to the corresponding product page.

  • Name
    product_id
    Required
    Required
    Description

    This parameter specifies the id of the eBay Product you want to retrieve data for. It is optional when item_id is present. Both can be used together if you want an specific item of said product, but the item page takes precedence.

    A product in eBay is a catalog record (canonical description of the thing) identified by an ePID, that can have multiple items from different sellers. For example a product Smartphone Brand X Model Y (with its specifications for hardware, battery, etc.) with its multiple items (with different sellers, prices, shipping, conditions, etc.). A product page shows information about the product and might contain information from one its items.

Localization

  • Name
    ebay_domain
    Required
    Optional
    Description

    The default parameter ebay.com defines the eBay domain of the search and it's used for multiple countries, but other country-specific domains are also supported. Check the full list of supported eBay domains.

  • Name
    country
    Required
    Optional
    Description

    A two-letter ISO 3166-1 alpha-2 country code that allows you to set the delivery country for the product or item and change the language and currency of the page (if available). The default will be the domain's country. Check the full list of supported eBay countries.

  • Name
    delivery_country
    Required
    Optional
    Description

    A two-letter ISO 3166-1 alpha-2 country code that allows you to set the an specific delivery country for the search. The default will be country if it's set, otherwise it will be the domain's country. Check the full list of supported eBay delivery countries.

  • Name
    postal_code
    Required
    Optional
    Description

    This parameter allows you to set the shipping postal code along with delivery_country for the search. It is not available for all delivery countries, check the full list of delivery countries that support postal codes, if not provided in those countries, eBay might automatically set a postal code.

Engine

  • Name
    engine
    Required
    Required
    Description

    This parameter defines an engine that will be used to retrieve real-time data. It must be set to ebay_product.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=ebay_product&item_id=403958102242
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_product",
  "item_id": "403958102242"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_OxE2l6wMgOJVS9Bdp9PbYq4K",
    "status": "Success",
    "created_at": "2025-05-06T10:13:26Z",
    "request_time_taken": 3.92,
    "parsing_time_taken": 0.11,
    "total_time_taken": 4.03,
    "request_url": "https://www.ebay.com/itm/403958102242",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_OxE2l6wMgOJVS9Bdp9PbYq4K.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_OxE2l6wMgOJVS9Bdp9PbYq4K"
  },
  "search_parameters": {
    "engine": "ebay_product",
    "item_id": "403958102242",
    "ebay_domain": "ebay.com",
    "country": "US"
  },
  "search_information": {
    "shipping_country": "United States",
    "language": "en"
  },
  "item": {
    "title": "Samsung Galaxy Tab S8+ 128GB, Wi-Fi + 5G (AT&T), 12.4 in - Graphite",
    "item_id": "403958102242",
    "seller": {
      "name": "Wilzee Corp",
      "reviews": 77556,
      "positive_feedback_percent": 97.7,
      "thumbnail": "https://i.ebayimg.com/images/g/CpUAAOSwYVVmagqK/s-l64.jpg"
    },
    "likes": 2,
    "price": "US $850.99",
    "extracted_price": 850.99,
    "condition": "Open box",
    "condition_snippet": "Condition! NO scratches The device has been thoroughly inspected Battery capacity is between",
    "is_buy_it_now": true,
    "buy_it_now_link": "https://www.ebay.com/atc/binctr?item=403958102242&quantity=1&fromPage=4429486&rev=3&fb=1&gch=1",
    "additional_service": "1-year protection plan from Allstate - $75.99",
    "shipping": "Free",
    "shipping_details": "Standard Shipping.",
    "located_in": "Located in: Maplewood, New Jersey, United States",
    "delivery": "Estimated between Fri, May 9 and Thu, May 14",
    "return_details": "30 days returns. Seller pays for return shipping.",
    "payment_methods": [
      "Klarna Installment",
      "PayPal",
      "Venmo",
      "Google Pay",
      "Visa",
      "Master Card",
      "Discover",
      "Diners Club"
    ],
    "extensions": [
      "People are checking this out. 2 have added this to their watchlist.",
      "Breathe easy. Free shipping and returns.",
      "eBay Money Back Guarantee. Get the item you ordered or your money back."
    ],
    "specifications": [
      {
        "name": "Condition",
        "value": "Open box"
      },
      ...
    ],
    "item_description_from_seller": "https://itm.ebaydesc.com/itmdesc/403958102242?t=0&category=171485&seller=wilzeecorp&excSoj=1&ver=0&excTrk=1&lsite=0&ittenable=true&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
    "main_image": "https://i.ebayimg.com/thumbs/images/g/bJoAAOSwMUpjVsSi/s-l500.jpg",
    "images": [
      {
        "link": "https://i.ebayimg.com/thumbs/images/g/bJoAAOSwMUpjVsSi/s-l500.jpg",
        "variant": "Picture 1 of 1"
      }
    ]
  },
  "product": {
    "product_id": "25052291698",
    "rating": 4.7,
    "feature_rating": [
      {
        "text": "Long battery life",
        "percentage": 100
      },
      ...
    ],
    "reviews": 6,
    "reviews_histogram": {
      "1": 0,
      "2": 0,
      "3": 1,
      "4": 0,
      "5": 5
    },
    "most_relevant_reviews": [
      {
        "title": "Awesome & Fast but pricey!",
        "text": "Faster than my Galaxy Tab S7+. Screen is OLED, so it's beautiful as the S7+. Sound quality is still loud and clear, even when maxed out. Price is too high. I would just recommend the S7+ for now.",
        "rating": 5,
        "user": "xxhotboyzbigkxx",
        "user_link": "https://www.ebay.com/usr/xxhotboyzbigkxx",
        "date": "Dec 08, 2022",
        "extensions": [
          "Verified purchase: Yes",
          "Condition: Pre-Owned",
          "Sold by: brferg456"
        ]
      },
      ...
    ],
    "specifications": [
      {
        "section": "Product Identifiers",
        "specifications": [
          {
            "name": "Brand",
            "value": "Samsung"
          },
          ...
        ]
      },
      ...
    ]
  },
  "about_seller": {
    "name": "Wilzee Corp",
    "bio": "Established in 2003, Wilzee's goal is to provide high-quality technology that is affordable and accessible to everyone.As a leading e-commerce retailer, we deliver expertly refurbished electronics that perform like new.Wise Investments in Leading Zealous Electronics Excellence!!!",
    "positive_feedback_percent": 97.7,
    "items_sold": 248000,
    "joined": "Joined Apr 2003",
    "link": "https://www.ebay.com/str/elgeocorp?_trksid=p4429486.m145687.l149267",
    "contact": "https://www.ebay.com/cnt/FindAnswers?ShowSellerFAQ=&item_id=403958102242&requested=wilzeecorp&redirect=0&frm=284&rt=nc&ssPageName=PageSellerM2MFAQ_VI&_trksid=p4429486.m145687.l149087&_caprdt=1",
    "feature_rating": [
      {
        "text": "Accurate description",
        "rating": 4.8
      },
      ...
    ],
    "popular_categories": [
      {
        "name": "Cameras & Photo",
        "link": "https://www.ebay.com/str/elgeocorp/Cameras-Photo/_i.html?store_cat=3930622"
      },
      ...
    ],
    "reviews": {
      "all_products": {
        "total": 77920,
        "reviews": [
          {
            "text": "Item as described. Fast shipping. Good communication. Packed well. Great value. Highly recommend this seller. A+",
            "is_positive": true,
            "user": "x***7",
            "reviews": 389,
            "date": "Past month",
            "is_verified_purchase": true,
            "product": "Dell Inspiron 13 5310 Laptop (i5-11320H 3.2 GHz 16GB 512GB SSD) C Key Broken (#316528634021)"
          },
          ...
        ]
      }
    }
  },
  "sections": [
    {
      "title": "People who viewed this item also viewed",
      "results": [
        {
          "title": "Samsung Galaxy Tab S8+ Plus X808U 12.4\" 128GB 5G Graphite (Verizon) - Good",
          "item_id": "165793732073",
          "link": "https://www.ebay.com/itm/165793732073",
          "price": "$339.99",
          "extracted_price": 339.99,
          "extensions": [
            "Free shipping"
          ],
          "is_sponsored": true,
          "thumbnail": "https://i.ebayimg.com/thumbs/images/g/ywAAAOSwvopjkhkU/s-l96.jpg"
        },
        ...
      ]
    },
    ...
  ],
  "related_searches": [
    {
      "query": "Samsung Galaxy Tab S8 128 GB",
      "link": "https://www.ebay.com/shop/samsung-galaxy-tab-s8-128gb?_nkw=samsung+galaxy+tab+s8+128gb"
    },
    ...
  ]
}

Item

Item
GET
https://www.searchapi.io/api/v1/search?engine=ebay_product&item_id=335606487650
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_product",
  "item_id": "335606487650"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "item": {
    "title": "Autoking Iron Man Gold MK5 Helmet Electronic Voice Activated Open&Close Mask New",
    "item_id": "335606487650",
    "seller": {
      "name": "3sunshop",
      "reviews": 702,
      "positive_feedback_percent": 97.2,
      "deal": {
        "text": "EXTRA $8 OFF 2+ ITEMS",
        "link": "https://www.ebay.com/str/3sunshop?_soffType=OrderSubTotalOffer&_soffid=14273417103&_tab=sales&_trksid=p2047675.m2197"
      },
      "thumbnail": "https://i.ebayimg.com/images/g/4FQAAOSwW29lg6NS/s-l64.jpg"
    },
    "price": "US $154.00",
    "extracted_price": 154,
    "original_price": "US $195.00",
    "extracted_original_price": 195,
    "discount": "(21% off)",
    "condition": "not specified",
    "condition_snippet": "New",
    "stock": "More than 10 available",
    "extracted_stock": 10,
    "items_sold": "507 sold",
    "extracted_items_sold": 507,
    "is_best_offer": true,
    "buy_it_now_link": "https://www.ebay.com/atc/binctr?item=335606487650&quantity=1&fromPage=4429486&rev=111&fb=1&gch=1",
    "place_offer_link": "https://signin.ebay.com/ws/eBayISAPI.dll?SignIn&ru=https%3A%2F%2Fwww.ebay.com%2Fitm%2F335606487650%3Fboolp%3D1",
    "shipping": "Free 2-4 day delivery",
    "located_in": "Located in: CA/NJ, United States",
    "delivery": "Get it between Thu, May 8 and Sat, May 10.",
    "return_details": "30 days returns. Buyer pays for return shipping. If you use an eBay shipping label, it will be deducted from your refund amount.",
    "payment_methods": [
      "PayPal",
      "Venmo",
      "Google Pay",
      "Visa",
      "Master Card",
      "Discover",
      "Diners Club"
    ],
    "extensions": [
      "Breathe easy. Returns accepted.",
      "People want this. 813 people are watching this.",
      "eBay Money Back Guarantee. Get the item you ordered or your money back."
    ],
    "specifications": [
      {
        "name": "Seller Notes",
        "value": "β€œNew”"
      },
      ...
    ],
    "item_description_from_seller": "https://itm.ebaydesc.com/itmdesc/335606487650?t=1746511182000&category=60361&seller=sunshine_parts&excSoj=1&ver=0&excTrk=1&lsite=0&ittenable=true&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
    "main_image": "https://i.ebayimg.com/thumbs/images/g/zJEAAOSw-c9oGaYa/s-l500.jpg",
    "images": [
      {
        "link": "https://i.ebayimg.com/thumbs/images/g/zJEAAOSw-c9oGaYa/s-l500.jpg",
        "variant": "Picture 1 of 24"
      },
      ...
    ],
    "videos": [
      {
        "thumbnail": "https://i.ebayimg.com/images/g/hiMAAOSwxL1nbO7N/s-l140.jpg",
        "variant": "Video 1 of 1"
      }
    ]
  }
}

Product

Product
GET
https://www.searchapi.io/api/v1/search?engine=ebay_product&product_id=20056257992
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_product",
  "product_id": "20056257992"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "product": {
    "title": "Apple iPhone 14 - 128 GB - Midnight (Unlocked)",
    "product_id": "20056257992",
    "item_id": "267237957666",
    "description": "These iPhone 14 5G 128GB models are CDMA and GSM compatible and have been UNLOCKED for use with any cellular network worldwide. IPHONE 14 5G 128GB. These iPhones are in NEW and UNUSED condition. FULL Apple warranty until October 2025!",
    "seller": {
      "name": "meloniesm19",
      "reviews": 3,
      "positive_feedback_percent": 100
    },
    "price": "$450.00",
    "extracted_price": 450,
    "shipping": "Free shipping",
    "delivery": "Est. delivery Sat, May 10 - Sat, May 17",
    "return_details": "No returns, but backed by eBay Money back guarantee.",
    "condition": "New",
    "is_buy_it_now": true,
    "buy_it_now_link": "https://www.ebay.com/atc/binctr?item=127066848261&quantity=1&fromPage=2380357&rev=3&fb=1&gch=1",
    "rating": 4.8,
    "feature_rating": [
      {
        "text": "Good value",
        "percentage": 100
      },
      ...
    ],
    "reviews": 41,
    "reviews_histogram": {
      "1": 1,
      "2": 0,
      "3": 0,
      "4": 3,
      "5": 37
    },
    "most_relevant_reviews": [
      {
        "title": "I purchased this used & it looks brand n...",
        "text": "I purchased this used & it looks brand new! It also has 100% battery life, which is great! I’m in US and wanted a phone with a physical SIM card & had no problems getting it to work!",
        "rating": 5,
        "user": "ricksmill",
        "user_link": "https://www.ebay.com/usr/ricksmill",
        "date": "Oct 19, 2024",
        "extensions": [
          "Verified purchase: Yes",
          "Condition: Pre-owned"
        ]
      },
      ...
    ],
    "specifications": [
      {
        "section": "Product Identifiers",
        "specifications": [
          {
            "name": "Brand",
            "value": "Apple"
          },
          ...
        ]
      },
      ...
    ],
    "item_description_from_seller": "https://itm.ebaydesc.com/itmdesc/127066848261?t=0&category=9355&seller=bbsurgeon31&excSoj=1&ver=0&excTrk=1&lsite=0&ittenable=true&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
    "main_image": "https://i.ebayimg.com/images/g/o2IAAOSwsFpkBxPL/s-l1600.png",
    "images": [
      {
        "link": "https://i.ebayimg.com/images/g/o2IAAOSwsFpkBxPL/s-l1600.png",
        "variant": "Stock photo",
        "is_stock_photo": true
      },
      ...
    ]
  }
}

About Seller

About Seller
GET
https://www.searchapi.io/api/v1/search?engine=ebay_product&item_id=193360503183
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_product",
  "item_id": "193360503183"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "about_seller": {
    "name": "A+ Electronics",
    "positive_feedback_percent": 99.6,
    "items_sold": 80000,
    "joined": "Joined Jan 2001",
    "response_time": "Usually responds within 24 hours",
    "link": "https://www.ebay.com/str/ev2hemi?_trksid=p4429486.m145687.l149267",
    "contact": "https://www.ebay.com/cnt/FindAnswers?ShowSellerFAQ=&item_id=193360503183&requested=ev2hemi&redirect=0&frm=284&rt=nc&ssPageName=PageSellerM2MFAQ_VI&_trksid=p4429486.m145687.l149087&_caprdt=1",
    "feature_rating": [
      {
        "text": "Accurate description",
        "rating": 4.9
      },
      ...
    ],
    "popular_categories": [
      {
        "name": "Books & Magazines",
        "link": "https://www.ebay.com/str/ev2hemi/Books-Magazines/_i.html?_sacat=267"
      },
      ...
    ],
    "reviews": {
      "this_product": {
        "total": 1030,
        "reviews": [
          {
            "text": "I recently purchased the green PSP. I couldn't be happier. The vibrant metallic green stands out in the best way. It arrived in great condition, especially considering its age.The system runs flawlessly. The screen has a slight discoloration around the edges, but it's bright and clear, buttons are responsive, and the sound quality is solid. Played my favorites like Crisis Core and Monster Hunter Freedom Unite, it brought back good memories.Highly recommend both the device and the seller!",
            "is_positive": true,
            "user": "o***k",
            "reviews": 4,
            "date": "Past 6 months",
            "is_verified_purchase": true
          },
          ...
        ]
      },
      "all_products": {
        "total": 20408,
        "reviews": [
          {
            "text": "A+++ seller, nice quality and appearance The packaging condition of the item was really good and nice. He is great to deal with, He sold the item at a fair price, answered all of my questions, the item was exactly as described and shown and it was packaged promptly in a neat way and arrived in a timely manner Highly recommended seller, would buy him again for sure. Great job and thank you for your kind service, honesty, support and consideration i really appreciate it god bless you. πŸ™πŸ»",
            "is_positive": true,
            "user": "u***a",
            "reviews": 48,
            "date": "Past 6 months",
            "is_verified_purchase": true,
            "product": "Red God Of War Sony PSP 2000 Battery Cover - Kratos (#195238978757)"
          },
          ...
        ]
      }
    }
  }
}

Sections

Sections
GET
https://www.searchapi.io/api/v1/search?engine=ebay_product&item_id=187210086838
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_product",
  "item_id": "187210086838"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "sections": [
    {
      "title": "People who viewed this item also viewed",
      "results": [
        {
          "title": "23cm Cute Capybara Plush Toys Capibara Anime Fluffty Toy Doll Backpack  Gifts",
          "item_id": "396619755979",
          "link": "https://www.ebay.com/itm/396619755979",
          "price": "$11.95",
          "extracted_price": 11.95,
          "extensions": [
            "Free shipping"
          ],
          "is_sponsored": true,
          "thumbnail": "https://i.ebayimg.com/thumbs/images/g/rWkAAOSwrvZoKILO/s-l96.jpg"
        },
        {
          "title": "Capybara Plush Toy Cute Capibara Anime Stuffed Animals Fluffy Doll",
          "item_id": "365589839172",
          "link": "https://www.ebay.com/itm/365589839172",
          "price": "$13.99",
          "extracted_price": 13.99,
          "extensions": [
            "Free shipping"
          ],
          "thumbnail": "https://i.ebayimg.com/thumbs/images/g/NM8AAOSwu59oHM4Q/s-l96.jpg"
        },
      ...
      ]
    }
  ]
}

Related Searches

Related Searches
GET
https://www.searchapi.io/api/v1/search?engine=ebay_product&item_id=135598535158
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "ebay_product",
  "item_id": "135598535158"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "related_searches": [
    {
      "query": "Cecilio Violin Cvn 300",
      "link": "https://www.ebay.com/shop/cecilio-violin-cvn-300?_nkw=cecilio+violin+cvn+300"
    },
    {
      "query": "4 Violin",
      "link": "https://www.ebay.com/shop/4-violin?_nkw=4+violin"
    },
    {
      "query": "Violin Wood",
      "link": "https://www.ebay.com/shop/violin-wood?_nkw=violin+wood"
    },
    ...
  ]
}