{"id":"55d0638c-d45f-4901-aa25-8da1810b1ffe","slug":"ebay-com-api","name":"ebay.com API","description":"eBay.com API providing access to item listings (active, completed, and sold), item details, seller profiles and feedback, category hierarchies, and search suggestions. Supports filtering by keyword, category, seller, condition, and sort order, with pagination for bulk data retrieval.","front_facing_description":"Search and monitor eBay listings across any category, with support for active and completed/sold listings. Retrieve item details, pricing history, seller profiles and feedback, and category data. Filter by keyword, category, condition, seller, and sort order to support price research, market analysis, and inventory monitoring.","source_url":"https://ebay.com","is_authenticated":false,"canonical_scraper_id":"caa8e1ad-f5a8-41c1-9bd2-54a8e19b6c35","apis":[{"method":"GET","endpoint_name":"search_listings","description":"Search for eBay listings with filters for category, seller, sold/completed status, and sorting. Returns paginated results with item titles, prices, conditions, and item IDs. Each page returns up to ~60 results from eBay's search results page.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination.","default":1},"sold":{"type":"boolean","required":false,"description":"Filter to sold items only.","default":false,"domain":{"kind":"open","example":false,"generator":{"type":"static","value":false}}},"sort":{"type":"string","required":false,"description":"Sort order code.","default":"12","enum":"SearchSort"},"query":{"type":"string","required":false,"description":"Search keyword. At least one of query, seller, or category_id should be provided.","domain":{"kind":"open","example":"iphone 15","generator":{"type":"static","value":"iphone 15"}}},"graded":{"type":"boolean","required":false,"description":"Filter to graded items only. Appends Graded=Yes to the search, useful for Collectible Card Games (category 2536) and related categories.","default":false,"domain":{"kind":"open","example":true,"generator":{"type":"static","value":false}}},"seller":{"type":"string","required":false,"description":"Seller username to filter results to a specific seller's listings.","domain":{"kind":"open","example":"thrift.books","generator":{"type":"static","value":""}}},"complete":{"type":"boolean","required":false,"description":"Filter to completed listings only.","default":false,"domain":{"kind":"open","example":false,"generator":{"type":"static","value":false}}},"category_id":{"type":"string","required":false,"description":"eBay category ID to filter by (numeric string).","domain":{"kind":"open","example":"175673","generator":{"type":"static","value":""}}}},"return_schema":{"type":"object","fields":{"total":"integer total number of matching listings","listings":"array of listing objects with title, price, url, image, condition, shipping, item_id, and date_sold"},"sample":{"data":{"total":41000,"listings":[{"url":"https://www.ebay.com/itm/296129124843","image":"https://i.ebayimg.com/images/g/lfYAAeSwjkZqKF4~/s-l500.webp","price":"$398.39","title":"Apple iPhone 15 128GB Factory Unlocked AT&T T-Mobile Verizon Very Good Condition","item_id":"296129124843","shipping":"$398.39$799.00","condition":"FREE FEDEX 2 DAY - 60 DAY RETURNS - 1 YEAR WARRANTY"}]},"status":"success"}},"initiates_session":false,"price":10,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.listings","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_item_details","description":"Retrieve full details of a single eBay item by its item ID, including title, price, condition, seller info, images, and item specifics (key-value pairs describing item attributes).","input_params":{"item_id":{"type":"string","required":true,"description":"eBay item ID (numeric string, e.g. '296129124843'). Obtainable from search_listings results.","domain":{"kind":"derived","generator":{"path":"$.data.listings[0].item_id","type":"derived","from_endpoint":"search_listings"}}}},"return_schema":{"type":"object","fields":{"price":"string formatted price with currency","title":"string item title","images":"array of image URLs (full resolution)","seller":"object with name (string) and feedback (string) fields","item_id":"string eBay item ID","condition":"string item condition description","specifics":"object of item specification key-value pairs"},"sample":{"data":{"price":"US $398.39","title":"Apple iPhone 15 128GB Factory Unlocked AT&T T-Mobile Verizon Very Good Condition","images":["https://i.ebayimg.com/images/g/lfYAAeSwjkZqKF4~/s-l1600.jpg"],"seller":{"name":"Supplytronics","feedback":"(144058)"},"item_id":"296129124843","condition":"Very Good - RefurbishedVery Good - RefurbishedMore information - About this item condition","specifics":{"Brand":"Apple","Model":"Apple iPhone 15","Storage Capacity":"128 GB"}},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.item_id","op":"not_null"},{"path":"$.data.title","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_completed_sold_listings","description":"Search for completed and sold eBay listings to track historical prices. Combines the sold and complete filters on eBay search. Returns the same listing format as search_listings.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination.","default":1},"sort":{"type":"string","required":false,"description":"Sort order code.","default":"12","enum":"SearchSort"},"query":{"type":"string","required":true,"description":"Search keyword.","domain":{"kind":"open","example":"nintendo switch","generator":{"type":"static","value":"nintendo switch"}}}},"return_schema":{"type":"object","fields":{"total":"integer total number of matching sold/completed listings","listings":"array of listing objects with title, price, url, image, condition, shipping, item_id, and date_sold"},"sample":{"data":{"total":37000,"listings":[{"url":"https://www.ebay.com/itm/236869582171","image":"https://i.ebayimg.com/images/g/hEMAAeSwwTBqKCBj/s-l500.jpg","price":"$285.00","title":"Nintendo Switch 2","item_id":"236869582171","shipping":"$285.00","condition":"Pre-Owned"}]},"status":"success"}},"initiates_session":false,"price":5,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.listings","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_seller_profile","description":"Get summary ratings and profile information for a seller including feedback scores, detailed seller ratings (accuracy, shipping cost, shipping speed), member details, and positive feedback percentage.","input_params":{"username":{"type":"string","required":true,"description":"Seller username (e.g. 'thrift.books').","domain":{"kind":"open","example":"thrift.books","generator":{"type":"static","value":"thrift.books"}}}},"return_schema":{"type":"object","fields":{"modules":"object containing PROFILE_HEADER, RATING_SUMMARY, DETAILED_SELLER_RATING_SUMMARY, FEEDBACK_SUMMARY_V2, USER_DETAIL, QUICK_LINKS, and other profile modules"},"sample":{"data":{"modules":{"USER_DETAIL":{"_type":"UserDetailModel","loginName":{"_type":"TextualDisplay","textSpans":[{"text":"thrift.books","_type":"TextSpan"}]},"feedbackScore":{"_type":"TextualDisplay","textSpans":[{"text":"4633512","_type":"TextSpan"}]},"positiveFeedbackSummary":{"_type":"TextualDisplay","textSpans":[{"text":"Positive Feedback (last 12 months): 99.6%","_type":"TextSpan"}]}}}},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.modules","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_seller_feedback","description":"Retrieve paginated feedback and reviews for a seller, including individual feedback cards with ratings, comments, item details, and pagination metadata.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination.","default":1},"limit":{"type":"integer","required":false,"description":"Results per page (25, 50, or 100).","default":25},"username":{"type":"string","required":true,"description":"Seller username (e.g. 'thrift.books').","domain":{"kind":"open","example":"thrift.books","generator":{"type":"static","value":"thrift.books"}}}},"return_schema":{"type":"object","fields":{"modules":"object containing FEEDBACK_SUMMARY_V2 module with feedbackView (feedbackCards array, totalFeedback, paginationModel)"},"sample":{"data":{"modules":{"FEEDBACK_SUMMARY_V2":{"_type":"FeedbackSummaryModel","feedbackView":{"feedbackCards":[{"_type":"FeedbackCard","feedbackId":"2726937455011","feedbackInfo":{"rating":{"name":"POSITIVE","_type":"Icon"},"comment":{"_type":"TextualDisplay","textSpans":[{"text":"Order delivered on time with no issues","_type":"TextSpan"}]}}}],"totalFeedback":{"_type":"TextualDisplay","textSpans":[{"text":"6,698,896 Feedback received (viewing 1-25)","_type":"TextSpan"}]}}}}},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.modules","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_seller_active_listings","description":"Search all active listings from a specific seller. Returns the same listing format as search_listings, filtered to a single seller's inventory.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination.","default":1},"sort":{"type":"string","required":false,"description":"Sort order code.","default":"12","enum":"SearchSort"},"username":{"type":"string","required":true,"description":"Seller username (e.g. 'thrift.books').","domain":{"kind":"open","example":"thrift.books","generator":{"type":"static","value":"thrift.books"}}}},"return_schema":{"type":"object","fields":{"total":"integer total number of active listings from the seller","listings":"array of listing objects with title, price, url, image, condition, shipping, item_id, and date_sold"},"sample":{"data":{"total":4500000,"listings":[{"url":"https://www.ebay.com/itm/372932891598","image":"https://i.ebayimg.com/images/g/GasAAOSwurZZMHS3/s-l500.jpg","price":"$4.58","title":"The Power of Now: A Guide to Spiritual Enlightenment by Tolle, Eckhart","item_id":"372932891598","shipping":"$4.58","condition":"by Tolle, Eckhart | PB | Good"}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.listings","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_categories","description":"Retrieve the hierarchy of eBay categories with their IDs and URLs. Returns all top-level and sub-categories available on eBay's all-categories page.","input_params":{},"return_schema":{"type":"object","fields":{"categories":"array of category objects with name, url, and category_id"},"sample":{"data":{"categories":[{"url":"https://www.ebay.com/b/Brand-Outlet/bn_7115532402","name":"Brand Outlet","category_id":"7115532402"},{"url":"https://www.ebay.com/b/Auto-Parts-and-Vehicles/6000/bn_1865334","name":"eBay Motors","category_id":"1865334"}]},"status":"success"}},"initiates_session":false,"price":5,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.categories","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_search_suggestions","description":"Get autocomplete search suggestions for a query prefix. Returns keyword suggestions that eBay would display in the search dropdown.","input_params":{"query":{"type":"string","required":true,"description":"Search query prefix (e.g. 'laptop').","domain":{"kind":"open","example":"laptop","generator":{"type":"static","value":"laptop"}}}},"return_schema":{"type":"object","fields":{"prefix":"string the query prefix that was searched","suggestions":"array of suggestion objects with keyword, type, and direct_type"},"sample":{"data":{"prefix":"laptop","suggestions":[{"type":"s","keyword":"laptop computers","direct_type":"SRP"},{"type":"s","keyword":"laptop gaming","direct_type":"SRP"}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.suggestions","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"get_categories":{},"search_listings":{"sold":"False","query":"iphone 15","graded":"False","complete":"False"},"get_item_details":{"item_id":"326776263388"},"get_seller_profile":{"username":"thrift.books"},"get_seller_feedback":{"username":"thrift.books"},"get_search_suggestions":{"query":"laptop"},"get_seller_active_listings":{"username":"thrift.books"},"get_completed_sold_listings":{"page":1,"query":"nintendo switch"}},"prefill_inputs":{"search_listings":{"sold":"False","query":"iphone 15","graded":"False","seller":"","complete":"False","category_id":""},"get_completed_sold_listings":{"query":"nintendo switch"},"get_seller_profile":{"username":"thrift.books"},"get_seller_feedback":{"username":"thrift.books"},"get_seller_active_listings":{"username":"thrift.books"},"get_search_suggestions":{"query":"laptop"}},"last_verified_at":"2026-11-01T02:03:53.017367+00:00","endpoint_health":[{"endpoint_name":"get_seller_feedback","status":"healthy","last_checked_at":"2026-11-01T02:03:53.017367+00:00","last_verified_at":"2026-11-01T02:03:53.017367+00:00","recent_runs":[{"at":"2026-11-01T02:03:53.017367+00:00","status":"healthy"},{"at":"2026-10-31T20:01:52.923507+00:00","status":"healthy"},{"at":"2026-10-31T13:04:25.225667+00:00","status":"healthy"},{"at":"2026-10-31T06:03:52.975884+00:00","status":"healthy"},{"at":"2026-10-30T23:00:52.973394+00:00","status":"healthy"}]},{"endpoint_name":"search_listings","status":"healthy","last_checked_at":"2026-11-01T02:03:53.017367+00:00","last_verified_at":"2026-11-01T02:03:53.017367+00:00","recent_runs":[{"at":"2026-11-01T02:03:53.017367+00:00","status":"healthy"},{"at":"2026-10-31T20:01:52.923507+00:00","status":"healthy"},{"at":"2026-10-31T13:04:25.225667+00:00","status":"healthy"},{"at":"2026-10-31T06:03:52.975884+00:00","status":"healthy"},{"at":"2026-10-30T23:00:52.973394+00:00","status":"healthy"}]},{"endpoint_name":"get_seller_active_listings","status":"healthy","last_checked_at":"2026-11-01T02:03:53.017367+00:00","last_verified_at":"2026-11-01T02:03:53.017367+00:00","recent_runs":[{"at":"2026-11-01T02:03:53.017367+00:00","status":"healthy"},{"at":"2026-10-31T20:01:52.923507+00:00","status":"healthy"},{"at":"2026-10-31T13:04:25.225667+00:00","status":"healthy"},{"at":"2026-10-31T06:03:52.975884+00:00","status":"healthy"},{"at":"2026-10-30T23:00:52.973394+00:00","status":"healthy"}]},{"endpoint_name":"get_item_details","status":"healthy","last_checked_at":"2026-11-01T02:03:53.017367+00:00","last_verified_at":"2026-11-01T02:03:53.017367+00:00","recent_runs":[{"at":"2026-11-01T02:03:53.017367+00:00","status":"healthy"},{"at":"2026-10-31T20:01:52.923507+00:00","status":"healthy"},{"at":"2026-10-31T13:04:25.225667+00:00","status":"healthy"},{"at":"2026-10-31T06:03:52.975884+00:00","status":"healthy"},{"at":"2026-10-30T23:00:52.973394+00:00","status":"healthy"}]},{"endpoint_name":"get_categories","status":"healthy","last_checked_at":"2026-11-01T02:03:53.017367+00:00","last_verified_at":"2026-11-01T02:03:53.017367+00:00","recent_runs":[{"at":"2026-11-01T02:03:53.017367+00:00","status":"healthy"},{"at":"2026-10-31T20:01:52.923507+00:00","status":"healthy"},{"at":"2026-10-31T13:04:25.225667+00:00","status":"healthy"},{"at":"2026-10-31T06:03:52.975884+00:00","status":"healthy"},{"at":"2026-10-30T23:00:52.973394+00:00","status":"healthy"}]},{"endpoint_name":"get_seller_profile","status":"healthy","last_checked_at":"2026-11-01T02:03:53.017367+00:00","last_verified_at":"2026-11-01T02:03:53.017367+00:00","recent_runs":[{"at":"2026-11-01T02:03:53.017367+00:00","status":"healthy"},{"at":"2026-10-31T20:01:52.923507+00:00","status":"healthy"},{"at":"2026-10-31T13:04:25.225667+00:00","status":"healthy"},{"at":"2026-10-31T06:03:52.975884+00:00","status":"healthy"},{"at":"2026-10-30T23:00:52.973394+00:00","status":"healthy"}]},{"endpoint_name":"get_completed_sold_listings","status":"ambiguous","last_checked_at":"2026-11-01T02:03:53.017367+00:00","last_verified_at":"2026-07-23T22:08:35.256247+00:00","recent_runs":[{"at":"2026-11-01T02:03:53.017367+00:00","status":"ambiguous"},{"at":"2026-10-31T20:01:52.923507+00:00","status":"ambiguous"},{"at":"2026-10-31T13:04:25.225667+00:00","status":"ambiguous"},{"at":"2026-10-31T06:03:52.975884+00:00","status":"ambiguous"},{"at":"2026-10-30T23:00:52.973394+00:00","status":"ambiguous"}]},{"endpoint_name":"get_search_suggestions","status":"healthy","last_checked_at":"2026-11-01T02:03:53.017367+00:00","last_verified_at":"2026-11-01T02:03:53.017367+00:00","recent_runs":[{"at":"2026-11-01T02:03:53.017367+00:00","status":"healthy"},{"at":"2026-10-31T20:01:52.923507+00:00","status":"healthy"},{"at":"2026-10-31T13:04:25.225667+00:00","status":"healthy"},{"at":"2026-10-31T06:03:52.975884+00:00","status":"healthy"},{"at":"2026-10-30T23:00:52.973394+00:00","status":"healthy"}]}],"sdk_usage_example":null,"sdk_delivery_state":"absent","summary":"Scraper for eBay marketplace data including search listings, item details, seller profiles, feedback, categories, and search suggestions.","updated_at":"2026-08-19T05:20:54.73267+00:00","user_variants":[],"latest_version":19,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Yes. eBay maintains an official set of REST and traditional APIs at https://developer.ebay.com. The official APIs require application registration, OAuth credentials, and are subject to eBay's developer program terms and call quotas.","q":"Does eBay have an official developer API?"},{"a":"It returns `images` (an array of full-resolution image URLs), `condition`, a `seller` object with name and feedback string, and a `specifics` object containing all item attribute key-value pairs eBay shows on the listing — things like brand, model number, storage capacity, or material, depending on the category.","q":"What does `get_item_details` return beyond the price and title?"},{"a":"Each feedback card in `get_seller_feedback` includes the comment text, rating, and item details, but individual buyer usernames are not guaranteed to be exposed — eBay frequently anonymizes them. The `totalFeedback` count and `paginationModel` are available for tracking volume over pages.","q":"Does the feedback endpoint return buyer identities or only comments?"},{"a":"The API covers standard eBay marketplace listings accessible via search and category filters. eBay Motors vehicle listings and eBay real estate classified ads have separate category structures and may not surface fully through standard search endpoints. You can fork this API on Parse and revise it to add dedicated endpoints targeting those category IDs.","q":"Are eBay Motors or real estate listings covered?"},{"a":"No watch-list or alert data is currently exposed — those features require an authenticated eBay session. The API covers public listing and seller data. You can fork it on Parse and revise to add polling logic against `search_listings` or `get_completed_sold_listings` to approximate price-change detection.","q":"Is there a way to get price alerts or watch-list data?"}],"keywords":["ebay listings api","ebay sold prices api","ebay item details api","ebay seller profile api","ebay completed listings api","ebay price history api","ebay search api","ebay category api","ebay seller feedback api","ebay product data api","ebay marketplace scraper api","ebay autocomplete suggestions api","ebay inventory monitoring api","ebay item specifics api"],"use_cases":["Track historical sale prices for a product by querying `get_completed_sold_listings` over time.","Monitor a competitor seller's active inventory using `get_seller_active_listings` filtered by `username`.","Aggregate item condition and pricing data across a category by combining `search_listings` with `category_id`.","Evaluate seller reputation before a purchase using `get_seller_profile` feedback scores and detailed ratings.","Build a product catalog enriched with item-specific attributes via the `specifics` field from `get_item_details`.","Populate a search autocomplete component using keyword suggestions from `get_search_suggestions`.","Map eBay category IDs to names for dynamic filtering by querying `get_categories` once and caching the result."],"meta_title":"eBay API – Listings, Sellers & Price Data","generated_at":"2026-06-16T21:14:41.853186+00:00","lead_paragraph":"The eBay API covers 8 endpoints that return structured data from eBay's marketplace, including active listings, historical sold prices, and seller profiles. The `search_listings` endpoint accepts keyword, category ID, and seller filters and returns up to ~60 results per page with title, price, condition, shipping, and item ID. Companion endpoints cover item-level specifics, seller feedback, and autocomplete suggestions.","schema_version":2,"meta_description":"Access eBay search listings, item details, sold/completed prices, seller profiles, feedback, and category data via a structured REST API.","primary_category":"marketplace","long_description_md":"## Search and Listing Data\n\nThe `search_listings` endpoint accepts a `query` string, `category_id`, `seller` username, and boolean `sold`/`complete` flags to filter results on eBay's marketplace. Each result in the `listings` array includes `title`, `price`, `condition`, `shipping`, `image`, `url`, and `item_id`. Pagination is controlled with the `page` parameter, and results are ordered using the `sort` input. For dedicated historical pricing research, `get_completed_sold_listings` applies both completed and sold filters in one call, returning the same listing shape.\n\n## Item and Seller Details\n\n`get_item_details` accepts an `item_id` (obtainable from any listing endpoint) and returns the full item record: `title`, `price`, `condition`, `images` (full-resolution URLs), a `seller` object with `name` and `feedback`, and a `specifics` object of key-value attribute pairs such as brand, model, color, or size. Seller-level data is split across two endpoints: `get_seller_profile` returns ratings, detailed seller ratings (accuracy, shipping cost, shipping speed), and member details, while `get_seller_feedback` returns paginated individual feedback cards with comments, ratings, and item references. The `limit` parameter on feedback accepts 25, 50, or 100 results per page.\n\n## Categories and Suggestions\n\n`get_categories` returns the full eBay category hierarchy — top-level and subcategories — with `name`, `url`, and `category_id` for each node. These IDs feed directly into the `category_id` filter on `search_listings`. `get_search_suggestions` takes a partial `query` and returns the autocomplete keyword suggestions eBay surfaces in its search dropdown, including each suggestion's `keyword`, `type`, and `direct_type` fields.\n\n## Seller Inventory\n\n`get_seller_active_listings` scopes a standard listing search to one seller using the `username` parameter, returning total count and the full listing array. Combined with `get_seller_feedback` and `get_seller_profile`, this gives a complete picture of any public seller's activity on eBay.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["ecommerce","reviews_ratings"]},"primary_category":"marketplace","secondary_categories":["ecommerce","reviews_ratings"],"access_requirements":[]}