eBay Seller API
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
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 Match1 - Time ending soonest10 - Time newly listed15 - Price + Shipping: lowest first16 - Price + Shipping: highest first7 - 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 Listings1 - Buy It Now2 - Auction
Serpapi Parameters
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.
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
eBay Seller API
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
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 Match1 - Time ending soonest10 - Time newly listed15 - Price + Shipping: lowest first16 - Price + Shipping: highest first7 - 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 Listings1 - Buy It Now2 - Auction
Serpapi Parameters
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.
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
{
...
"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
{
...
"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.
{
...
"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"
}
]
}
}
Example for seller with featured categories
For some sellers of type=store, the banner and featured categories information will be available in the results.
{
...
"featured_categories": [
{
"title": "Home Improvement",
"link": "https://www.ebay.com/str/comfortchoice/Home-Improvement/_i.html?_sacat=159907",
"thumbnail": "https://i.ebayimg.com/images/g/xEYAAOSw88xkGlM0/s-l225.jpg",
"thumbnail_height": 1200,
"thumbnail_width": 1200
},
{
"title": "Yard, Garden & Outdoor Living",
"link": "https://www.ebay.com/str/comfortchoice/Yard-Garden-Outdoor-Living/_i.html?_sacat=159912",
"thumbnail": "https://i.ebayimg.com/images/g/aGIAAOSwVCVkGlOL/s-l225.jpg",
"thumbnail_height": 1200,
"thumbnail_width": 1200
},
{
"title": "Tools & Workshop Equipment",
"link": "https://www.ebay.com/str/comfortchoice/Tools-Workshop-Equipment/_i.html?_sacat=631",
"thumbnail": "https://i.ebayimg.com/images/g/hhAAAOSwv81kGlPE/s-l225.jpg",
"thumbnail_height": 1200,
"thumbnail_width": 1200
},
{
"title": "Sporting Goods",
"link": "https://www.ebay.com/str/comfortchoice/Sporting-Goods/_i.html?_sacat=888",
"thumbnail": "https://i.ebayimg.com/images/g/0wAAAOSwFbZkGlPl/s-l225.jpg",
"thumbnail_height": 1600,
"thumbnail_width": 1600
},
{
"title": "Toys & Hobbies",
"link": "https://www.ebay.com/str/comfortchoice/Toys-Hobbies/_i.html?_sacat=220",
"thumbnail": "https://i.ebayimg.com/images/g/SvcAAOSwnbhkGlRo/s-l225.jpg",
"thumbnail_height": 1200,
"thumbnail_width": 1200
},
{
"title": "Furniture",
"link": "https://www.ebay.com/str/comfortchoice/Furniture/_i.html?_sacat=3197",
"thumbnail": "https://i.ebayimg.com/images/g/bBcAAOSwyBhkGlSu/s-l225.jpg",
"thumbnail_height": 1200,
"thumbnail_width": 1200
}
],
...
}
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"
}
}
}