Ebay Organic Results API

Ebay search main results are called organic results. Some results are simple and straightforward. Others include rich data like reviews, condition, shipping and other special snippets. SerpApi is able to scrape, extract, and make sense of both simple and more complex organic results.

API Examples

JSON structure overview

{
  ...
  "organic_results": [
    {
      "sponsored": "Boolean - Indicate whether item is sponsored",
      "new_listing": "Boolean - Indicate whether item is a new listing",
      "title": "String - Title of the item",
      "subtitle": "String - Subtitle of the item",
      "link": "String - Link to the item",
      "condition": "String - Condition of the item (Ex: 'Brand New', 'Open Box', 'Pre-Owned')",
      "rating": "Float - Rating of the item",
      "reviews": "Integer - Number of reviews of the item",

      # Single price
      "price": {
        "raw": "String - Price as shown on the page",
        "extracted": "Float - Extracted price of the item"
      },
      # Price range
      "price": {
        "from": {
          "raw": "String - Price as shown on the page",
          "extracted": "Float - Extracted price of the item"
        },
        "to": {
          "raw": "String - Price as shown on the page",
          "extracted": "Float - Extracted price of the item"
        }
      },

      "old_price" : {
        "raw": "String - Old price as shown on the page",
        "extracted": "Float - Extracted old price of the item",
        "discount": "Float - Discount percentage"
      },

      "shipping": "String - Shipping information of the item (Ex: 'Free Shipping')",
      # Shipping with estimated cost
      "shipping": {
        "raw": "String - Shipping cost as shown on the page",
        "extracted": "String - Extracted shipping cost of the item"
      },

      "returns": "String - Returns information of the item (Ex: 'Free returns')",
      "top_rated": "Boolean - Indicate whether seller is top rated",
      "location": "String - Location of the seller",
      "bids": {
        "count": "Integer - Number of bids",
        "time_left": "String - Time left before auction ends"
      },
      "extensions": "Array - List of other attributes of item (Ex: 'eBay Refurbished')",
      "delivery": "String - Delivery information of the item (Ex: 'FAST 'N FREE', 'Guaranteed by Fri, May. 15')",
      "buying_options": {
        "text": "String - Text of the buying option",
        "link": "String - Link to the buying option"
      },
      "quantity_sold": "String - Quantity sold of the item as show on the page",
      "extracted_quantity_sold": "Integer - Extracted quantity sold of the item",
      "thumbnail": "String - Thumbnail URL of the item",
      "promotion": "String - Promotion information of the item (Ex: 'Save up to 20% when you buy more')",
      "seller": {
        "username": "String - Username of the seller",
        "reviews": "Integer - Number of reviews of the seller",
        "positive_feedback_in_percentage": "Float - Positive feedback percentage of the seller",
      },
      "stock_status": "String - Stock status of the item (Ex: 'Almost gone', 'Last one')",
      "watchers": "String - Number of watchers on the item as shown on the page",
      "extracted_watchers": "Integer - Extracted number of watchers of the item",
    },
  ],
} 

Organic results overview

When SerpApi encounters organic results, we add them to our JSON output as the array organic_results. For each organic result, we are able to extract its title, subtitle, link, condition, price, shipping, seller, thumbnail and more.

Organic results overview

JSON Example

{
  ...
  "organic_results": [
    {
      "sponsored": true,
      "title": "Kaffeto Gourmet Cafe Latte with Ganoderma Coffee 100 Sachets",
      "link": "https://www.ebay.com/itm/255997789761?hash=item3b9aa84641:g:dqYAAOSwsJNkI3yO&amdata=enc%3AAQAHAAAAwPFCjHD1MC3Pc8%2Fq06WaEvu%2FWwOgjy5RhbTlph2rcwBQPbErAdTPhaIXQnAr32xRVArMiyEFj1xMUS%2Fb5Ta3%2BowDMj9YHSfx%2BA2k4mw%2F5hQZyuhWZRQ9vl3XM6f2aDFH02YHrv7pZwRZahgG8GhOflM%2BclScIoTXNAn2XpcX3yq8cPTrAeTMwrXza71ZDvXoZmYKuKPz7bNEHEVDchCAsX63HgbHKg2pR3rCPE%2BMdRU69hsEWhIoSs3MnNA5mQ4p9A%3D%3D%7Ctkp%3ABlBMUIqgpP7uYQ",
      "condition": "Brand New",
      "price": {
        "raw": "$80.95",
        "extracted": 80.95
      },
      "shipping": "Free 4 day shipping",
      "returns": "Free returns",
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/dqYAAOSwsJNkI3yO/s-l225.jpg",
      "promotion": "Save up to 15% when you buy more",
      "seller": {
        "username": "nybase",
        "reviews": 728,
        "positive_feedback_in_percentage": 98.2
      }
    },
    {
      "sponsored": true,
      "title": "Mexican Robusta Coffee Petapa, Oaxaca, Mexico",
      "subtitle": "Robusta Mexicana",
      "link": "https://www.ebay.com/itm/225343936313?var=524332194979&hash=item34778b9739:g:K2YAAOSwhd1jvgW2&amdata=enc%3AAQAHAAAAsO%2BFtqqFhX99xJJpRSTQymqf0rZNHTTsHImCApzZllq7TNESkG%2BkqSHXxj2d838WG8%2Frud6cAjpcDaQCad%2BWBeE5pZhG%2FFZuJ2it9fEW0fNV2wubDzhn9YHOx6H%2FJy3lIzn6YJ2dTMhiE0dlT%2FQ96KlchJCXt8MIyQjZwev7SYL2otQMdLbbzDdeQgfiq%2B3ZmLBSKAz2C0RegFijIv6qlB0EOFKdtkDryOMOCcpm%2Fuul%7Ctkp%3ABlBMUIqgpP7uYQ",
      "condition": "Brand New",
      "price": {
        "from": {
          "raw": "$10.00",
          "extracted": 10
        },
        "to": {
          "raw": "$19.00",
          "extracted": 19
        }
      },
      "shipping": "Free shipping",
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/K2YAAOSwhd1jvgW2/s-l225.jpg",
      "promotion": "Extra 8% off with coupon",
      "seller": {
        "username": "isla-coffee",
        "reviews": 850,
        "positive_feedback_in_percentage": 99.2
      }
    },
    {
      "sponsored": true,
      "title": "DECAF COLOMBIAN COFFEE SINGLE SERVE CUPS 50 CUPS ROASTED FRESH WEEKLY",
      "link": "https://www.ebay.com/itm/112362444611?hash=item1a2952d743:g:0m0AAOSwImRYUd3g&amdata=enc%3AAQAHAAAAwL0IgrKeaEZYkS0hfm%2BtaJw6%2FDp%2BtrAFzyckbb7ictjqg4XnZYn9SUfb%2BRAH2lqN5KJlIYIQmuX5jN%2FJiTY6riRGP8DvYus4TB21snvrrcnPePWd2JLyArOFcvm4TGlaqPh%2BrzrF0GIGqQC9ckuHwVfZxNbLswhFHKqIzP5cT3tsKJnWJWGtcjOCDkjyX3SvAI77sgAjkwxM0YoXy%2FrsX50EQ%2FBumJ0vNYNdgGtU7V7JKIX%2BiA%2BSRy%2BqvbpfOrxnhA%3D%3D%7Ctkp%3ABlBMUIqgpP7uYQ",
      "condition": "Brand New",
      "price": {
        "raw": "$26.99",
        "extracted": 26.99
      },
      "shipping": "Free 4 day shipping",
      "quantity_sold": "145 sold",
      "extracted_quantity_sold": 145,
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/0m0AAOSwImRYUd3g/s-l225.jpg",
      "seller": {
        "username": "koffeeexpress",
        "reviews": 24147,
        "positive_feedback_in_percentage": 100
      }
    },
    ...
  ],
  ...
}

Example results: old_price

Example results: old_price

JSON Example

{
  ...
  "organic_results": [
    {
      "sponsored": true,
      "title": "Apple AirPods Pro (2nd Gen) In-Ear Wireless Earbuds MQD83ZA/A & Charging Case",
      "link": "https://www.ebay.com/itm/394210095449?hash=item5bc8c0b159:g:WeQAAOSwZOhj7el5&amdata=enc%3AAQAIAAAAwIG7E2VtzXxiKm9nJ2Ybh2sd5%2B16lrwFKAf%2FLQKBmIAmwcK%2BnajelfR4oNWT1%2FSncQrH07hanh3hpDTO0WL1tMqjytyJKP%2FrhCIpXT916oea7H%2BxCX4r%2B9gWsx7yKN4G%2FuqTNjIIJRDsmofoWWtO7sE9PAeKM7qHd31a5UC1felJMyYhh1cEX6EEbCoUoy%2F02K8iJHXrb9qNqIOC3vHcSXgqEni20NNdTYxdUugT7NBkPzl0OLba2zpVqmAi%2FD580Q%3D%3D%7Ctkp%3ABk9SR6Lsvv7uYQ",
      "condition": "Open Box",
      "price": {
        "raw": "$113.70",
        "extracted": 113.7
      },
      "old_price": {
        "raw": "$138.66",
        "extracted": 138.66,
        "discount": "18% off"
      },
      "shipping": "Free shipping",
      "top_rated": true,
      "returns": "Free returns",
      "quantity_sold": "273+ sold",
      "extracted_quantity_sold": 273,
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/WeQAAOSwZOhj7el5/s-l225.jpg",
      "seller": {
        "username": "yasmin7896",
        "reviews": 1180,
        "positive_feedback_in_percentage": 99.5
      }
    },
    ...
  ],
  ...
}

Example results: rating and reviews

Example results: rating and reviews

JSON Example

{
  ...
  "organic_results": [
    {
      "sponsored": true,
      "title": "Green Mountain Our Blend Coffee K Cup 24CT - Sell by Date 5/29/2023",
      "link": "https://www.ebay.com/itm/385231580535?epid=1101095163&hash=item59b1976d77:g:4fwAAOSwJoJjcdjS&amdata=enc%3AAQAHAAAAsNFM0dCQI4cOS5VOkRhsK0FRwsH3JONSTCpts3Y0pVVwGz4VfR8eWT6n4vQEhrvSz0%2BfFjO4l6%2Fr50j%2FtPuCS73DdYrVkajXCgUSc05abLiW0rwStzy%2FX0YGI5qTFc%2B3d%2BMjJuo9lj%2FrwZ2UpyEmq6dQKCDBAXXkgpVsvfir7cptNpAkwZ%2FwiVB06xrwH5hn0yf0tbDpUfkuKgGmjpFKSjjbKhw8jsAPK1PnD%2BfA0vi1%7Ctkp%3ABlBMUIqgpP7uYQ",
      "condition": "Brand New",
      "rating": 5,
      "reviews": 3,
      "price": {
        "raw": "$35.10",
        "extracted": 35.1
      },
      "shipping": "Free shipping",
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/4fwAAOSwJoJjcdjS/s-l225.jpg",
      "promotion": "Save up to 65% when you buy more",
      "seller": {
        "username": "theemallgroup",
        "reviews": 42142,
        "positive_feedback_in_percentage": 99
      }
    },
    ...
  ],
  ...
}

Example results: shipping with estimated cost

Example results: shipping with estimated cost

JSON Example

{
  ...
  "organic_results": [
    {
      "sponsored": true,
      "title": "Black Rifle Coffee Company CAF Blend Medium Roast Ground 12 Oz Bag High Quality",
      "link": "https://www.ebay.com/itm/275569709910?epid=8008165446&hash=item40293c1356:g:GnkAAOSwMmtjj7AL&amdata=enc%3AAQAHAAAAwEx%2FclDQQd5dTl1Yq9O%2BNMrarULbw%2FZBVlkc8a7yVcQx6A%2FvNYZj8q62NKuuU%2FGe4AtfaVICd9MgxQ0C6GRjQycX6khr5kFHpyTa%2F4KwStgiVicwfKBaNppXlRCYqiZMeQnqqVp5M0Y4K%2FbJRWLbjjsre5YOlPQ4kcSzGZkPw09T3S3eegGKdolEXD1E5X%2BMZsH%2Bg9gDyaowZzr0WW%2FLG3vxMJcMe%2FaG3co2%2BVWRm%2FQ4kHj1HVSGqtj064LAc52qMw%3D%3D%7Ctkp%3ABk9SR4ygpP7uYQ",
      "condition": "Brand New",
      "rating": 4.5,
      "reviews": 16,
      "price": {
        "raw": "$6.00",
        "extracted": 6
      },
      "shipping": {
        "raw": "+$6.35",
        "extracted": 6.35
      },
      "quantity_sold": "67 sold",
      "extracted_quantity_sold": 67,
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/GnkAAOSwMmtjj7AL/s-l225.jpg",
      "seller": {
        "username": "newarctic",
        "reviews": 169,
        "positive_feedback_in_percentage": 97.5
      }
    },
    ...
  ],
  ...
}

Example results: stock_status

Example results: stock_status

JSON Example

{
  ...
  "organic_results": [
    {
      "sponsored": true,
      "title": "Apple AirPods Pro Earbuds with Wireless Charging Case - MWP22AM/A",
      "link": "https://www.ebay.com/itm/134352978326?hash=item1f480fc196:g:C7cAAOSw9kFkESm3&amdata=enc%3AAQAIAAAA4PuaQ%2FKKCft6tjd0crVA%2BrvN5fHkqVATpHmc3ZrGBhXDMhjD7YC5hStQbjvlmJ1NZswHGwa1qPS2dwolc%2BaL081JqW3XAsEFHx%2Fhc9tALGgguUBobZfZ36xYXDkI9cTbl1iijP9Co6vnLCxbVRYGWDBmjWlCvUDrSsh%2BJ4roWsDmOxxX%2B%2BCGre3YaOMJdKtT334jz00a1WVJSSQbjXutlOyTa2h1JN3Map%2BJDGauxwB%2FxY4Dz4XmYkWeQ%2FkLdKl51v3kAHSwWZeongZGtT%2FtP8tP9jZR1fdmaiVdzMSbk1Nv%7Ctkp%3ABk9SR6jsvv7uYQ",
      "condition": "Open Box",
      "price": {
        "raw": "$129.00",
        "extracted": 129
      },
      "shipping": "Free shipping",
      "returns": "Free returns",
      "quantity_sold": "90 sold",
      "extracted_quantity_sold": 90,
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/C7cAAOSw9kFkESm3/s-l225.jpg",
      "seller": {
        "username": "colaniy-1868",
        "reviews": 332,
        "positive_feedback_in_percentage": 98.3
      },
      "stock_status": "Almost gone"
    },
    ...
  ],
  ...
}

Example results with _sop: 16 (Price + Shipping: highest first)

Example results with _sop: 16 (Price + Shipping: highest first)

JSON Example

{
  ...
  "organic_results": [
    {
      "sponsored": true,
      "title": "10x100 PACKS IN CRATE ROOM COFFEE WEIGHT CONTROL PRODUCT IN THE ICON GROUP",
      "link": "https://www.ebay.com/itm/166149957319?hash=item26af4f26c7:g:URkAAOSwWL9kffFi&amdata=enc%3AAQAIAAAAwO0GfFWQhXkDiypfgO785t3sBES5ldTQIzEYuL13AZPQlGFVLW22kzDhUTTh2ObLmzU7ffoDThUyiko%2BBdqlyUvWwoS6a%2BMnWojIuVy6TleCClhEXnKdytEs%2FoQfai4dJZhd7%2FGBZU0x9fXD1Fkrx4O7zdSImfkyAOS%2Bdg3cegPe8ShMbt9I2u3fTpNPasaMQlbcdyhPrzQNZyBYI81CrPC5wh%2BRIr6qiblrfWelMI67IwGl0HEwOb2vRSeyigrFNQ%3D%3D%7Ctkp%3ABk9SR9jM4rS1Yg",
      "condition": "Brand New",
      "price": {
        "raw": "$10,600.00",
        "extracted": 10600.0
      },
      "shipping": {
        "raw": "+$4,500.00",
        "extracted": 4500.0
      },
      "location": "from Thailand",
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/URkAAOSwWL9kffFi/s-l300.jpg",
      "seller": {
        "username": "singharach",
        "reviews": 1,
        "positive_feedback_in_percentage": 100
      }
    },
    {
      "sponsored": true,
      "title": "ORIGINAL COFFEE CAN “SUPPLY and SERVICE STORES” EXTREMELY RARE MILITARY Key Wind",
      "link": "https://www.ebay.com/itm/275847265173?hash=item4039c73b95:g:uiwAAOSwOSpkYiDh&amdata=enc%3AAQAIAAAA4EfKMop4LLmFr%2BnD9mUQfomI0Wof7o%2B21CMnhNsncQz25GZC9dh4tsRLe9kR%2B7H%2BhQKp6Yb5u3gKZCRqwN6HHBc35G%2BpjL3o%2BvuVqY6D6DnVtjPkDJy%2BMNxjopHExspJu8mQKpP8BZG3%2BjuBamCCi7brKFHZYbQwdot9Bq2%2BxnoDkSSHIkI%2BodhwgGdlnaD60JcdP7UhwQRgUGpGkU0JOnzOVoPMde29yVlyn9KovHpsQdzMAnu3e8yp4jq8wnhjD60J2gucEg4i%2BDzGbAPA3D9XvnkV%2F%2FvVy0EQBkuph1dI%7Ctkp%3ABk9SR9jM4rS1Yg",
      "condition": "Pre-Owned",
      "price": {
        "raw": "$10,000.00",
        "extracted": 10000.0
      },
      "shipping": {
        "raw": "+$25.00",
        "extracted": 25.0
      },
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/uiwAAOSwOSpkYiDh/s-l300.jpg",
      "seller": {
        "username": "americangraffiti54",
        "reviews": 1129,
        "positive_feedback_in_percentage": 100
      }
    },
    {
      "sponsored": true,
      "title": "3x100 PACKS IN CRATE ROOM COFFEE WEIGHT CONTROL PRODUCT IN THE ICON GROUP",
      "link": "https://www.ebay.com/itm/166149941495?hash=item26af4ee8f7:g:0mcAAOSwkpFkffEZ&amdata=enc%3AAQAIAAAA4GoKTgl7Ngh4QVBSZ9wP2rw%2FitIwOMHdJ8P1MgUw87ECrvJGnpT9gG54hm6g%2BaTmUipMfUPaMArNd%2FXth7QZcbnBqy9t1HRfMMuBEFBiBKOUU%2B4tttn28m85ppPWMJ59TiJ8cwmpL0Cn0IsyYenJPF9yVSbdfp1qK53%2FBKwGb7%2B%2B5r3ADqXmIa0hD7mV%2FKxI6Lvr0vGeOZSIWpbs9kXGIDxzxkdBZNlYuJZgag6rPxH85tPi3bwVGK93uKnhcwf1iRbpilfNFx2bDujyiR4PKle6TwKIDyAxir%2FzG7hUeVes%7Ctkp%3ABk9SR9jM4rS1Yg",
      "condition": "Brand New",
      "price": {
        "raw": "$3,180.00",
        "extracted": 3180.0
      },
      "shipping": {
        "raw": "+$1,515.00",
        "extracted": 1515.0
      },
      "location": "from Thailand",
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/0mcAAOSwkpFkffEZ/s-l300.jpg",
      "seller": {
        "username": "singharach",
        "reviews": 1,
        "positive_feedback_in_percentage": 100
      }
    },
    ...
  ],
  ...
}