Core APIs
...
Ebay
Core Requests

Search

3min

Ebay Search Results

DESKTOP TABLET MOBILE

SerpWow parses Ebay search results when the engine=ebay request parameter is set.

Ebay Search Results
Ebay Search Results


Below is an example of how Ebay search results are represented in the SerpWow result JSON:

JSON



SerpWow returns the following properties for engine=ebay requests:

Property

Type

Description

ebay_results

array

An array of Ebay Search Result objects, containing each of the product results shown on the Search Results page. The Ebay Search Result object has the following properties:

  • position
  • number
  • The position of the result on the search results page.



  • title
  • string
  • The product name.



  • epid
  • string
  • The Ebay product ID (EPID) for the listing.



  • link
  • string
  • The product page link.



  • image
  • string
  • A link to the image of the product.



  • hotness
  • string
  • The value of the 'hotness' entry shown next to the product listing.



  • condition
  • string
  • The condition of the product in the listing.



  • is_auction
  • boolean
  • True/false indicating whether this is an auction-format listing.



  • buy_it_now
  • boolean
  • True/false indicating whether this listing offers a Buy-It-Now price.



  • free_returns
  • boolean
  • True/false indicating whether this listing offers free returns.



  • sponsored
  • boolean
  • True/false indicating whether this listing is sponsored (i.e. promoted).



  • best_offer_accepted
  • boolean
  • Set to true when the "Best Offer accepted" text is shown next to the search result.



  • best_offer
  • boolean
  • Set to true when the "Best Offer" text is shown next to the search result (different from best_offer_accepted in that just "Best Offer" is shown, not "Best Offer Accepted").



  • is_rewritten_result
  • boolean
  • Set to true when this search result appears beneath the "Results matching fewer words" banner (meaning the search result doesn't exactly match the search_term and has been suggested as an alternative). An example of the "Results matching fewer words banner is shown below. If you wish to exlude rewritten results use the allow_rewritten_results=false request parameter.
    • 

      Document image
      



  • item_location
  • string
  • The item location, if shown next to the search result.



  • rating
  • number
  • The overall rating of the product, out of 5.



  • ratings_total
  • number
  • The total number of customer ratings the product has received.



  • shipping_cost
  • number
  • A number describing the shipping cost of the item.



  • prices
  • array
  • Prices Array The prices array contains details about the products pricing, as shown underneath the product title. It is an array of price objects, the properties of which are described below:
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The price of the Offer.
    • 
      1. currency
      2. string
      3. The currency of the Offer as a ISO 4217 currency code.
    • 
      1. raw
      2. string
      3. The raw price as displayed on the Offer listing.
    • 
      1. name
      2. string
      3. The name of the price if applicable, for example "low" and "high" in the case of a range price. If the name property is empty then this price is the only price shown against the product.



  • ended
  • object
  • Ended Object An object describing how the listing ended, if shown. Typically displayed when the completed_items=true request parameter is used. The properties of the ended object are described below:
    • 
      1. type
      2. string
      3. Set to ended when the listing was shown as "Ended", set to sold when the listing was shown as "Sold". Can be used as an indicator of whether listing ended naturally, or resulted in a sale. - https://apiimages.imgix.net/serpwow/images/png/docs/search_result_ended_date.png?auto=format&ixlib=react-9.5.1-beta.1&w=250
    • 
      1. date
      2. object
      3. An object describing the date on which the listing ended naturally or was sold. Contains a string property raw containing the raw date string of the listing end as shown next to the search result.



  • price
  • object
  • A price object representing the first item in the prices array. This is normally the "main" or "lowest" (in the case of a range) price for the product and is included as a convienience to make extracting the main price easier.

pagination

object

An object containing details of the pagination section of the page.

  • current
  • number
  • The current page number, if shown.


Next Steps      Ebay Search Parameters

Updated 15 Aug 2024
Did this page help you?