# eBay Search & Products **eBay Search & Products** is an independently documented x402 Atlas bridge at https://ebay.use.x402atlas.com. This document describes only this bridge; it does not aggregate routes, schemas, or content from any other bridge. ## How payment works Paid operations use the [x402 payment protocol](https://x402.org) and settle in USDC. Atlas supports deployments on Base, Polygon, and Arbitrum, plus configured Solana networks. This bridge currently advertises Arbitrum One (`eip155:42161`), Base (`eip155:8453`), Polygon (`eip155:137`), Solana mainnet (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`). 1. Send the HTTP request without a payment signature. 2. Read the `402 Payment Required` response. Its `accepts` entries are the authoritative network, asset, amount, and recipient options for that call. 3. Select an option, sign it with an x402-compatible wallet or SDK, and repeat the request with the `PAYMENT-SIGNATURE` header. The successful response is returned after verification and settlement. TypeScript clients can automate the challenge, signing, and retry flow with [`x402-fetch`](https://www.npmjs.com/package/x402-fetch) or [`x402-axios`](https://www.npmjs.com/package/x402-axios). Fund a dedicated wallet only with the working USDC balance it needs and keep that key separate from treasury accounts. ## Pricing Atlas route prices start at $0.005 per successful call. This bridge's fallback price is $0.005; operations below state their exact configured price in `x-x402` and `x-payment-info`. The live `402` challenge remains authoritative. ## Worked payment example Request one documented operation without a signature to inspect its live terms: ```bash curl -i 'https://ebay.use.x402atlas.com/product?domain=ebay.com&product_id=366158095231' # HTTP/1.1 402 Payment Required # Read accepts[].network, asset, amount, and payTo from this response. ``` Sign one accepted option and repeat the identical request with the `PAYMENT-SIGNATURE` header. Do not invent or cache payment terms; read them from the current challenge. ## Use this API - Interactive reference: https://ebay.use.x402atlas.com/docs - OpenAPI 3.1 specification: https://ebay.use.x402atlas.com/openapi.json - Agent-readable route corpus: https://ebay.use.x402atlas.com/llms.txt - Endpoint index: https://ebay.use.x402atlas.com/index.json Use the operation schemas and examples below to construct requests. Copy the server URL, path, method, parameters, and request body from the operation you want to call. Path and query examples are concrete and can be used directly. ## Atlas response metadata Successful JSON responses include an additive top-level `_atlas` block, kept separate from the bridge's data fields. `_atlas.docs` links this bridge's `/llms.txt` corpus. `_atlas.related` suggests adjacent APIs, each with a callable `url`, its own `docs` link, and a short `summary`. Suppress this block by sending `X-Atlas-Meta: none` or by adding `?_atlas=0` to the request. ## Errors and compatibility Validation failures use HTTP `400`. Paid operations may return `402` before dispatch. Upstream and internal failures use the documented `5xx` responses. Clients should rely on documented fields and tolerate additive response fields, including `_atlas` unless they explicitly opt out. ## Protocol reference - x402 protocol and SDKs: https://x402.org ## eBay Search & Products Docs: https://ebay.use.x402atlas.com/docs · OpenAPI: https://ebay.use.x402atlas.com/openapi.json ### GET /product eBay listing detail — one listing by product id: buy options & current bid, variants, shipping to a supported destination, seller reputation, item specifics, stock & watch counts as clean JSON. Full eBay listing detail by item id. Pass the `product_id` from a `/search` item (or lift it from an ebay.com/itm/ URL) and get back the listing's complete profile: title, condition, description, images, buy options (Buy It Now price, current bid with count and time left, best-offer flag), coupon, stock and quantity-sold signals, rating and review count, watchers, item specifics (about-this-item and product details as key/value maps), category breadcrumb, variation menus and purchasable combinations with prices, shipping options with cost and delivery window (use a supported two-letter `shipping_country` destination like CA or DE), the distilled return policy and accepted payment methods — plus the seller's reputation (rating, positive-feedback %, items sold) and related listings, each with a `details_link` back into this route. `domain` selects the regional eBay site the listing lives on (default ebay.com). A completely parameterless request uses the published canonical example through the durable example cache. A partial request with a missing or non-numeric `product_id` returns 400 before any paid upstream work; an unknown or ended listing returns 200 with an empty profile because the lookup ran. **Price:** $0.02 per call. Parameters: - `domain` (optional, string) — eBay regional site the listing lives on; default: `"ebay.com"`; example: `"ebay.com"` - `product_id` (required, string) — Numeric eBay item id, from /ebay/search items[].product_id (or an ebay.com/itm/ URL); pattern: `"^[0-9]+$"`; example: `"366158095231"` - `shipping_country` (optional, string) — Calculate shipping to a supported destination using its two-letter code (e.g. US, CA, DE); pattern: `"^[A-Za-z]{2}$"` Example: ```sh curl 'https://ebay.use.x402atlas.com/product?domain=ebay.com&product_id=366158095231' ``` Response example: ```json { "product": { "buy": { "buy_it_now": { "price": { "extracted": 770.99, "raw": "$770.99" } } }, "categories": [ "Electronics", "Video Games \u0026 Consoles", "Video Game Consoles" ], "condition": "New", "link": "http://www.ebay.com/itm/366158095231", "media": [ "https://i.ebayimg.com/images/g/VSMAAeSwfshoLzF9/s-l1600.jpg", "https://i.ebayimg.com/images/g/IX0AAeSwvzdoLzF9/s-l1600.jpg" ], "payment_methods": [ "Klarna Installment", "PayPal", "Venmo", "Google Pay", "Visa", "Master Card", "Discover", "Diners Club", "Klarna", "Paypal Credit" ], "product_id": "366158095231", "quantity": { "availability_signal": "6 available", "available": 6, "sold": 85 }, "returns": { "accepted": true, "period": "30 days", "refund_method": "Money Back" }, "shipping": { "destination": "United States", "options": [ { "method": "FedEx Ground / FedEx Home Delivery®" } ], "origin": "Rolling Meadows, Illinois, United States", "status": "available" }, "short_description": "Lightning Speed Harness the power of a custom CPU, GPU, and SSD with Integrated I/O that rewrite the rules of what a PlayStation console can do. 1TB of storage. 1TB of Storage. This Sony Playstation 5 Slim Disc Console Bundle is in New condition.", "specifications": { "about_this_item": { "Brand": "Sony", "Model": "SNY-BD-PS5SLIM", "Platform": "Sony PlayStation 5", "Storage Capacity": "1 TB", "Type": "Home Console" } }, "title": "Sony PS5 Slim Disc Console 1TB 2x Controllers \u0026amp; Charging Station SNY-BD-PS5SLIM", "watch_count": 99 }, "queried_at": "2026-10-19T12:00:00Z", "related_products": [ { "details_link": "https://ebay.use.x402atlas.com/product?product_id=336793733754", "price": { "extracted": 629.99, "raw": "$629.99" }, "product_id": "336793733754", "thumbnail": "https://i.ebayimg.com/thumbs/images/g/J7kAAeSw4NdqV7mt/s-l500.jpg", "title": "Sony Playstation 5 - PS5 Slim Disc Edition 1TB Console w/ Accessories Included" } ], "seller": { "name": "Hyper Microsystems", "positive_feedback_percent": 99.6, "profile_link": "https://www.ebay.com/str/hypermicrosystems", "rating": 100149, "sold_count": 358000, "username": "hypermicrosystems" } } ``` ### GET /search eBay listings search — live prices, condition, shipping, seller reputation, auctions & Buy It Now across supported regional eBay sites, with category, price band, condition, seller & location filters, sorted, as clean JSON. Live eBay listings search: pass a free-text `query` (anything usable in a regular eBay search) and get back normalized listings — price (single or range, with the extracted number), condition, shipping cost and free-shipping flag, returns note, seller reputation (username, review count, positive-feedback %), auction state (bids, time left), quantity sold, watchers and badges. `domain` selects the regional eBay site (default ebay.com). Filter with `category_id` (ids come back in `categories[]`), `min_price`/`max_price`, `condition` (comma-separated ids: 1000 New, 1500 Open box, 2000 Certified refurbished, 2500 Seller refurbished, 3000 Used, 10 Not specified), `buying_format` (Auction | BIN | BO), `show_only` extra filters (FR free returns, RPA returns accepted, AS authorized seller, Savings, SaleItems, Lots, Charity, AV Authenticity Guarantee, FS free shipping, LPickup local pickup), `seller` usernames, `location` (Domestic | Regional | Worldwide) and `postal_code`. Sort with `sort`; page with `page`/`per_page` (25|50|100|200) and follow `next_page`. Each item carries a `details_link` pointing at this API's `/product` route for the full listing. A query with no matches returns 200 with an empty `items` list; an omitted `query` returns this route's sample response (the declared example plus a `note`). **Price:** $0.02 per call. Parameters: - `buying_format` (optional, string) — Buying format: Auction, Buy It Now (BIN) or Accepts Offers (BO); allowed: ["Auction","BIN","BO"]; example: `"BIN"` - `category_id` (optional, integer) — Numeric eBay category id to narrow results (ids come back in categories[] of a previous search); minimum: `1` - `condition` (optional, string) — Comma-separated condition ids: 1000 New, 1500 Open box, 2000 Certified refurbished, 2500 Seller refurbished, 3000 Used, 10 Not specified; example: `"3000"` - `domain` (optional, string) — eBay regional site to search; allowed: ["ebay.at","ebay.ca","ebay.ch","ebay.co.uk","ebay.com","ebay.com.au","ebay.com.hk","ebay.com.my","ebay.com.sg","ebay.de","ebay.es","ebay.fr","ebay.ie","ebay.it","ebay.nl","ebay.pl"], default: `"ebay.com"`; example: `"ebay.com"` - `location` (optional, string) — Preferred item location; allowed: ["Domestic","Regional","Worldwide"]; example: `"Domestic"` - `max_price` (optional, number) — Maximum price filter; minimum: `0`; example: `800` - `min_price` (optional, number) — Minimum price filter; minimum: `0`; example: `100` - `page` (optional, integer) — Result page number; follow next_page from a previous response; default: `1`, minimum: `1`; example: `1` - `per_page` (optional, integer) — Results per page; allowed: [25,50,100,200], default: `50`; example: `50` - `postal_code` (optional, string) — ZIP/postal code for location-based shipping and distance - `query` (required, string) — Free-text search query — anything usable in a regular eBay search (e.g. "iphone 15 pro"); maxLength: `300`; example: `"iphone 15 pro"` - `seller` (optional, string) — Comma-separated eBay seller usernames — only their listings - `show_only` (optional, string) — Comma-separated extra filters (case-sensitive): FR free returns, RPA returns accepted, AS authorized seller, Savings deals, SaleItems sale items, Lots lots, Charity charity, AV Authenticity Guarantee, FS free shipping, LPickup local pickup - `sort` (optional, string) — Sort order; allowed: ["best_match","ending_soonest","newly_listed","price_shipping_lowest","price_shipping_highest","distance_nearest"], default: `"best_match"`; example: `"price_shipping_lowest"` Example: ```sh curl 'https://ebay.use.x402atlas.com/search?buying_format=BIN&condition=3000&domain=ebay.com&location=Domestic&max_price=800&min_price=100&page=1&per_page=50&query=iphone+15+pro&sort=price_shipping_lowest' ``` Response example: ```json { "categories": [ { "id": 15032, "name": "Cell Phones \u0026 Accessories" }, { "id": 43304, "name": "Cell Phone \u0026 Smartphone Parts" } ], "domain": "ebay.com", "items": [ { "condition": "Pre-Owned", "details_link": "https://ebay.use.x402atlas.com/product?product_id=137819987434", "link": "https://www.ebay.com/itm/137819987434?_skw=iphone+15+pro\u0026epid=5062777530\u0026itmmeta=01M59VTRNZAW3RTH3E3Q5W7YDM\u0026hash=item2016b61dea%3Ag%3AktcAAeSwuf1qxWi%7E\u0026itmprp=enc%3AAQALAAAA8CHNgUiiE%2FjQhlDTaMiAde%2BPn%2BTn68wSgsf0BL7hD8YdCOY00%2F7Qq1JSM%2BsL3iSnJ1NwrL66FycHLvVA6nfmQwQ69OiylrOyLK7g7pEiuwDR6xtCLvF%2FgoQB226bjlyFXtBNP2JG5kNwRoKL2Rdr0%2FeJ8u5332zql%2BW4Ab73HCad5wtwfveUr%2BYaDO%2BNmhlBuWWX9z9RpwHJn1SBW7H3beGY3u%2FoXO1xK5KA1byLwHgrppSwswBMgZeKdBPyvnjV058dPtSwN2WysLAvW1Z%2B877lCQOxCltCIHpx8yk4VVWbAxvRcsjq1DYV%2B%2B%2FZGWvuRw%3D%3D%7Ctkp%3ABk9SR7iL67uqaA\u0026LH_BIN=1\u0026LH_ItemCondition=3000", "location": "Located in United States", "price": { "extracted": 314.99, "raw": "$314.99" }, "product_id": "137819987434", "rating": 4.5, "reviews_count": 19, "seller": { "positive_feedback_percent": 99.5, "review_count": 436, "username": "sellyourgadgetssodo" }, "shipping": { "extracted": 9.95, "free": false, "raw": "+$9.95 delivery" }, "subtitle": "Apple iPhone 15 Pro ·", "thumbnail": "https://i.ebayimg.com/images/g/ktcAAeSwuf1qxWi~/s-l500.webp", "title": "Apple iPhone 15 Pro 128GB Black - Unlocked *See Photos*", "watchers": 13 }, { "condition": "Pre-Owned", "details_link": "https://ebay.use.x402atlas.com/product?product_id=257801826268", "link": "https://www.ebay.com/itm/257801826268?_skw=iphone+15+pro\u0026epid=20062769737\u0026itmmeta=01M59VTRPG796TDF6FRG6WXS54\u0026hash=item3c062fafdc%3Ag%3Ad0gAAeSwog1q0pUQ\u0026itmprp=enc%3AAQALAAAA0CHNgUiiE%2FjQhlDTaMiAde%2Bl5dmvEbaqmBDalYGh1E4Uq2AdoFmFkrvIR%2BHI74OWdiJ6zma3UaLREEOElH8w2yh4oJclqoODg9gs6AihY3eWNdDe3y%2FlK11AwwfmLXcIB%2FIgZgSLxvpJnG4aNyetH6bIaxGlVRwZZpzKRqVVybycn%2BHCinPdkWg9WTnFT5vlTAL4Jj7yfFjsv70Ds39lPw4AWlFXWlfW5NaDl0CRFW29mKPupVA8Y5mUVgc6On1L9EKcrwGXDIOjepq9Aiy4Tes%3D%7Ctkp%3ABk9SR7yL67uqaA\u0026LH_BIN=1\u0026LH_ItemCondition=3000", "location": "Located in United States", "price": { "extracted": 389.99, "raw": "$389.99" }, "product_id": "257801826268", "returns": "Free returns", "seller": { "positive_feedback_percent": 99.9, "review_count": 6400, "username": "webtradeinllc" }, "shipping": { "free": true, "raw": "Free delivery" }, "subtitle": "Apple iPhone 15 Pro ·", "thumbnail": "https://i.ebayimg.com/images/g/d0gAAeSwog1q0pUQ/s-l500.webp", "title": "Apple iPhone 15 Pro 128GB Natural (AT\u0026T Cricket ONLY) Excellent Never Repaired" } ], "next_page": 2, "page": 1, "per_page": 50, "query": "iphone 15 pro", "related_searches": [ "iphone 14 pro", "iphone 15 pro unlocked", "iphone 16 pro" ], "total_results": 1200 } ```