API Parameters

Search Query

seller_id

Required

Parameter defines an ID of the seller to get results for. It can be found in the username field of our eBay Search API and eBay Product API results, or in seller links: https://www.ebay.com/usr/{seller_id}.

Store Type

type

Required

Parameter defines the type of the seller. The available options are user and store. You can find the seller type using our eBay Product API.

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.

Pagination

_pgn

Optional

Parameter defines the page number. It's used for pagination. (e.g., 1 (default) is the first page of results, 2 is the 2nd page of results, 3 is the 3rd page of results, etc.).

_ipg

Optional

Parameter defines the maximum number of results to return. There are three options: 24, 48 (default), and 72 results.

Advanced Ebay Parameters

_sop

Optional

Parameter defines results sorted by different options in the eBay. The default option is 'Best Match'.

Available options:

12 - Best Match
1 - Time ending soonest
10 - Time newly listed
15 - Price + Shipping: lowest first
16 - Price + Shipping: highest first
7 - Distance: nearest first

buying_format

Optional

Parameter defines the buying format you can apply to the results. The default option is 'All Listings'.

Available options:

0 - All Listings
1 - Buy It Now
2 - Auction

LH_ItemCondition

Optional

Parameter defines one or multiple product conditions to limit the search to. Condition is represented via numeric ID. There are three options: 3 for New, 4 for Used, 10 for Not Specified. Multiple IDs should be joined with | delimiter, e.g. 3|4.

free_shipping

Optional

Show only products with free shipping.

Serpapi Parameters

engine

Required

Set parameter to ebay_seller to use the eBay Seller API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the eBay Seller 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.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a markdown-formatted version optimized for LLMs and AI agents.

json_restrictor

Optional

Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

API Examples

Our eBay Seller API allows you to scrape results from the eBay seller page.


The API endpoint is https://serpapi.com/search?engine=ebay_seller

Head to the playground for a live and interactive demo.

API Parameters

Search Query

seller_id

Required

Parameter defines an ID of the seller to get results for. It can be found in the username field of our eBay Search API and eBay Product API results, or in seller links: https://www.ebay.com/usr/{seller_id}.

Store Type

type

Required

Parameter defines the type of the seller. The available options are user and store. You can find the seller type using our eBay Product API.

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.

Pagination

_pgn

Optional

Parameter defines the page number. It's used for pagination. (e.g., 1 (default) is the first page of results, 2 is the 2nd page of results, 3 is the 3rd page of results, etc.).

_ipg

Optional

Parameter defines the maximum number of results to return. There are three options: 24, 48 (default), and 72 results.

Advanced Ebay Parameters

_sop

Optional

Parameter defines results sorted by different options in the eBay. The default option is 'Best Match'.

Available options:

12 - Best Match
1 - Time ending soonest
10 - Time newly listed
15 - Price + Shipping: lowest first
16 - Price + Shipping: highest first
7 - Distance: nearest first

buying_format

Optional

Parameter defines the buying format you can apply to the results. The default option is 'All Listings'.

Available options:

0 - All Listings
1 - Buy It Now
2 - Auction

LH_ItemCondition

Optional

Parameter defines one or multiple product conditions to limit the search to. Condition is represented via numeric ID. There are three options: 3 for New, 4 for Used, 10 for Not Specified. Multiple IDs should be joined with | delimiter, e.g. 3|4.

free_shipping

Optional

Show only products with free shipping.

Serpapi Parameters

engine

Required

Set parameter to ebay_seller to use the eBay Seller API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the eBay Seller 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.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a markdown-formatted version optimized for LLMs and AI agents.

json_restrictor

Optional

Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

API Results

JSON Results

JSON output includes structured data for the seller.

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 yet supported by SerpApi. It gives you the raw HTML results from eBay Seller.

Markdown Results

Markdown output is optimized for LLMs and AI agents. It provides most of the same informational content as JSON in a token-efficient format using tables, markdown links, and YAML frontmatter.

To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.

API Examples

Example for seller with page number  _pgn: 2

Example for seller with page number  _pgn: 2

JSON Example

{
  ...
  "seller_results": {
    "type": "user",
    "name": "premiersportscards1",
    "username": "premiersportscards1",
    "ssn": "premiersportscards1",
    "bio": "Premier Sports Cards is one of eBay's most reputable sellers. Consistently delivers outstanding customer service. Please read about the item and description boxes for all the information on the cards. High quality scans of front and back included in listing.",
    "follower_count": 44,
    "positive_feedback_in_percentage": 100,
    "sold_count": 498,
    "profile_link": "https://www.ebay.com/usr/premiersportscards1",
    "logo_link": "https://i.ebayimg.com/images/g/DXQAAeSwS8ZoWJjr/s-l140.jpg",
    "rating": 542,
    "number_of_products": 133,
    "popular_categories": {
      "list": [
        {
          "title": "Sports Mem, Cards & Fan Shop",
          "link": "https://www.ebay.com/usr/premiersportscards1/Sports-Mem-Cards-Fan-Shop/_i.html?_sacat=64482",
          "category_id": "64482"
        },
        {
          "title": "Collectibles",
          "link": "https://www.ebay.com/usr/premiersportscards1/Collectibles/_i.html?_sacat=1",
          "category_id": "1"
        }
      ],
      "see_all_link": "https://www.ebay.com/sch/i.html?_dkr=1&iconV2Request=true&_blrs=recall_filtering&_ssn=premiersportscards1&_oac=1"
    }
  },
  ...
}

Example for seller with  buying_format: Auction and  _sop: Time: ending soonest

Example for seller with  buying_format: Auction and  _sop: Time: ending soonest

JSON Example

{
  ...
  "product_results": [
    {
      "position": 1,
      "product_id": "127891600947",
      "product_link": "https://www.ebay.com/itm/127891600947?itmmeta=01KT7RHZH2Z4YZHRAWCJVQC4XV&hash=item1dc6eef633%3Ag%3ABqEAAeSwpZlqGUj7&LH_Auction=1",
      "title": "2018 Bowman Draft Ryan Jeffers Chrome Auto Refractor 1st #/499 Twins PSA 9",
      "price": {
        "amount": 31,
        "currency": "USD"
      },
      "thumbnail": "https://i.ebayimg.com/images/g/BqEAAeSwpZlqGUj7/s-l300.jpg",
      "thumbnail_height": 1600,
      "thumbnail_width": 976,
      "availability_signal": "1 remaining",
      "shipping": "+$4.99 delivery Jun 6 - Jun 11",
      "bid_count": 16,
      "auction_time_remaining": "1h 20m",
      "serpapi_link": "https://serpapi.com/search.json?ebay_domain=ebay.com&engine=ebay_product&product_id=127891600947"
    },
    {
      "position": 2,
      "product_id": "127891601154",
      "product_link": "https://www.ebay.com/itm/127891601154?epid=12086930080&itmmeta=01KT7RHZH2R4AKCJVN9P9H82K0&hash=item1dc6eef702%3Ag%3A62EAAeSw7NRqGUjP&LH_Auction=1",
      "title": "2025 Bowman Chrome University Maalik Murphy Black Shimmer Refractor 1st #/10",
      "price": {
        "amount": 26,
        "currency": "USD"
      },
      "thumbnail": "https://i.ebayimg.com/images/g/62EAAeSw7NRqGUjP/s-l300.jpg",
      "thumbnail_height": 1600,
      "thumbnail_width": 1200,
      "availability_signal": "1 remaining",
      "shipping": "+$4.99 delivery Jun 6 - Jun 11",
      "bid_count": 19,
      "auction_time_remaining": "1h 20m",
      "serpapi_link": "https://serpapi.com/search.json?ebay_domain=ebay.com&engine=ebay_product&product_id=127891601154"
    },
    ...
  ],
  ...
}

Example for seller with  type: user

For sellers of type=user, the feedback information will be available in the results.

Example for seller with  type: user

JSON Example

  {
    ...
    "feedback": {
      "overall_rating": {
        "title": "Feedback ratings",
        "subtitle": "Last 12 months",
        "ratings": [
          {
            "label": "Positive",
            "count": 189
          },
          {
            "label": "Neutral",
            "count": 0
          },
          {
            "label": "Negative",
            "count": 0
          }
        ]
      },
      "detailed_rating": {
        "title": "Detailed seller ratings",
        "subtitle": "Average for the last 12 months",
        "ratings": [
          {
            "detail": "Accurate description",
            "rating": 4.9
          },
          {
            "detail": "Reasonable shipping cost",
            "rating": 5
          },
          {
            "detail": "Shipping speed",
            "rating": 5
          },
          {
            "detail": "Communication",
            "rating": 5
          }
        ]
      },
      "seller_feedback": [
        {
          "comment": "The item arrived quickly and the packaging was in great condition. Seller was very prompt with shipping and honest with the listing description. It was priced competitively. When it was delivered, I saw that the item was packaged appropriately. When I opened it, it was exactly as it was described in the listing. The item was in perfect condition. It  was exactly what I was looking for. I love it! I would definitely purchase from this seller again. Thank you.",
          "time": "Past 6 months",
          "rating": "POSITIVE"
        },
        {
          "comment": "The item was new i nbox as described by the seller. However, when it came, the plastic was all broken up. I do not know if the package was like that when the seller shipped it or if it happens in transit. But all in all the product was as described and I would purchase from the seller again.",
          "time": "Past 6 months",
          "rating": "POSITIVE"
        },
        {
          "comment": "Our favorite Yankee Candle Scents arrived yesterday and I was impressed that everything was wrapped perfectly and with care. Shipping time was great and both candles were exactly as advertised. What a great experience with this seller, I look forward to giving them more business in the future A+++. \n\nThank You Again!",
          "time": "Past month",
          "rating": "POSITIVE"
        },
        {
          "comment": "Pants are as described and pictured. They weee packed well and shipped fast. Great seller! ",
          "time": "Past 6 months",
          "rating": "POSITIVE"
        },
        {
          "comment": "Great communication! Fast shipping! As described, and awesome value! Thank you so much!",
          "time": "Past 6 months",
          "rating": "POSITIVE"
        },
        {
          "comment": "All good as expected. It came from a long way away, so by the time it was delivered, the package looked like it had been tossed around a football field. There was no substantial packing inside to protect the product. With long distance mailings, I would recommend a large bubble wrap packing material in the future to protect the product and the box. Much appreciated.",
          "time": "Past month",
          "rating": "POSITIVE"
        }
      ]
    }
  }

JSON Structure Overview

{
  ...
  "seller_results": {
    "type": "String - 'store' or 'user'",
    "name": "String - Seller's display name",
    "username": "String - Seller's username",
    "ssn": "String - Seller's unique identifier (same as username)",
    "bio": "String - Seller's bio or description",
    "follower_count": "Integer - Number of followers the seller has",
    "positive_feedback_in_percentage": "Float - Percentage of positive feedback",
    "sold_count": "Integer - Total number of items sold by the seller",
    "profile_link": "String - URL to the seller's eBay profile",
    "logo_link": "String - URL to the seller's profile picture or logo",
    "rating": "Integer - Seller's total number of ratings",
    "banner": { // Only available for 'store' sellers
      "thumbnail": "String - URL to the banner image",
      "thumbnail_height": "Integer - Image height in pixels",
      "thumbnail_width": "Integer - Image width in pixels",
      "text": "String - Text overlay on the banner (if available)",
      "video": { // Only available if the banner contains a video slide
        "link": "String - URL to the video playlist",
        "thumbnail": "String - URL to the video thumbnail image",
        "height": "Integer - Video height in pixels",
        "width": "Integer - Video width in pixels"
      }
    },
    "popular_categories": {
      "list": [
        {
          "title": "String - Name of the category",
          "link": "String - URL to the seller's listings in that category",
          "category_id": "String - eBay ID of the category"
        },
      ],
      "see_all_link": "String - URL to see all categories the seller has listings in"
    }     
  },
  "featured_categories": [ // Only available for some 'store' sellers
    {
      "title": "String - Name of the featured category",
      "link": "String - URL to the seller's listings in that category",
      "thumbnail": "String - URL to the category image",
      "thumbnail_height": "Integer - Image height in pixels",
      "thumbnail_width": "Integer - Image width in pixels"
    }
  ],
  "product_results": [
    {
      "position": "Integer - Position of the product in the search results",
      "product_id": "String - Unique identifier for the product",
      "product_link": "String - URL to the product listing",
      "title": "String - Title of the product",
      "price": {
        "amount": "Float - Price amount",
        "currency": "String - Currency code (e.g., 'USD')"
      },
      "old_price": { // Only available if the product price was lowered
        "amount": "Float - Original price amount",
        "currency": "String - Currency code (e.g., 'USD')"
      },
      "thumbnail": "String - URL to the product image",
      "thumbnail_height": "Integer - Image height in pixels",
      "thumbnail_width": "Integer - Image width in pixels",
      "availability_signal": "String - Quantity available (e.g., '1 remaining')",
      "shipping": "String - Shipping cost (e.g., 'Free Shipping' or '$5.99 Shipping')", // Only available if the product has a shipping cost listed
      "extension": "String - Additional information about the product (e.g., 'Save up to 20% when you buy more')",
      "bid_count": "Integer - Number of bids", // Only available for auction listings
      "auction_time_remaining": "String - Time remaining in the auction (e.g., '1h 20m')", // Only available for auction listings
      "serpapi_link": "String - URL to the SerpApi endpoint for this eBay product"
    }
  ],
  "about": { // Only available for 'user' sellers
    "description": "String - Description of the seller's store",
    "location": "String - Seller's location",
    "member_since": "String - Date when the seller joined eBay"
  },
  "feedback": { // Only available for 'user' sellers
    "overall_rating": {
      "title": "String - Title for overall feedback ratings",
      "subtitle": "String - Subtitle for overall feedback ratings",
      "ratings": [
        {
          "label": "String - Label for the rating (e.g., 'Positive')",
          "count": "Integer - Count of feedbacks for that rating"
        },
      ]
    },
    "detailed_rating": {
      "title": "String - Title for detailed seller ratings",
      "subtitle": "String - Subtitle for detailed seller ratings",
      "ratings": [
        {
          "detail": "String - Detail category (e.g., 'Accurate description')",
          "rating": "Float - Average rating for that detail category"
        },
      ]
    },
    "seller_feedback": [
      {
        "comment": "String - Text of the feedback comment",
        "time": "String - Timeframe of the feedback (e.g., 'Past 6 months')",
        "rating": "String - Rating associated with the feedback (e.g., 'POSITIVE')"
      },
    ]
  },
  "pagination": { // Only available if there are multiple pages of results
    "current": "Integer - Current page number",
    "next": "String - URL to the next page of results (if available)",
    "previous": "String - URL to the previous page of results (if available)",
    "other_pages": {
      "1": "String - URL to page 1 of results",
      "2": "String - URL to page 2 of results"
    }
  },
  "serpapi_pagination": {
    "current": "Integer - Current page number",
    "previous_link": "String - URL to the previous page of results (if available)",
    "previous": "String - URL to the previous page of results (if available)",
    "next_link": "String - URL to the next page of results (if available)",
    "next": "String - URL to the next page of results (if available)",
    "other_pages": {
      "1": "String - URL to page 1 of results",
      "2": "String - URL to page 2 of results"
    }
  }
}