eBay listings search — live prices, condition, shipping, seller reputation, auctions & Buy
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.
20000 (raw units)
price
3
calls / 30d
2
unique payers
2026-09-15
updated
Provider
ebay.use.x402atlas.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "20000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "20000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "20000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"category": "ecommerce",
"info": {
"input": {
"method": "GET",
"queryParams": {
"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"
},
"type": "http"
},
"output": {
"example": {
"categories": [
{
"id": 9355,
"name": "Cell Phones & Smartphones"
},
{
"id": 20349,
"name": "Cell Phone & Smartphone Parts"
}
],
"domain": "ebay.com",
"items": [
{
"condition": "Pre-Owned",
"details_link": "https://ebay.use.x402atlas.com/product?product_id=146252519201",
"extensions": [
"Free returns",
"Top Rated Plus"
],
"link": "https://www.ebay.com/itm/146252519201",
"location": "United States",
"price": {
"extracted": 489.99,
"raw": "$489.99"
},
"product_id": "146252519201",
"quantity_sold": 412,
"returns": "Free returns",
"seller": {
"positive_feedback_percent": 99.2,
"review_count": 48213,
"username": "certified.tech.deals"
},
"shipping": {
"free": true,
"raw": "Free shipping"
},
"sponsored": false,
"thumbnail": "https://i.ebayimg.com/images/g/aB0AAOSw1x9mQ2Zx/s-l500.jpg",
"title": "Apple iPhone 15 Pro 128GB Natural Titanium (Unlocked) - Very Good Condition"
},
{
"condition": "Pre-Owned",
"details_link": "https://ebay.use.x402atlas.com/product?product_id=156733902118",
"discount": "20% off",
"link": "https://www.ebay.com/itm/156733902118",
"location": "United States",
"original_price": {
"extracted": 649,
"raw": "$649.00"
},
"price": {
"extracted": 519,
"raw": "$519.00 to $589.00"
},
"product_id": "156733902118",
"rating": 4.5,
"reviews_count": 231,
"seller": {
"positive_feedback_percent": 98.7,
"review_count": 10544,
"username": "phoneup_store"
},
"shipping": {
"extracted": 12.4,
"free": false,
"raw": "+$12.40 shipping"
},
"sponsored": false,
"thumbnail": "https://i.ebayimg.com/images/g/kQ4AAOSwXy5nGt2p/s-l500.jpg",
"title": "Apple iPhone 15 Pro 256GB Blue Titanium Unlocked"
}
],
"next_page": 2,
"page": 1,
"per_page": 50,
"query": "iphone 15 pro",
"related_searches": [
"iphone 15 pro max",
"iphone 15 pro unlocked",
"iphone 14 pro"
],
"total_results": 8347
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"buying_format": {
"description": "Buying format: Auction, Buy It Now (BIN) or Accepts Offers (BO)",
"enum": [
"Auction",
"BIN",
"BO"
],
"type": "string"
},
"condition": {
"description": "Comma-separated condition ids: 1000 New, 1500 Open box, 2000 Certified refurbished, 2500 Seller refurbished, 3000 Used, 10 Not specified",
"type": "string"
},
"domain": {
"default": "ebay.com",
"description": "eBay regional site to search",
"enum": [
"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"
],
"type": "string"
},
"location": {
"description": "Preferred item location",
"enum": [
"Domestic",
"Regional",
"Worldwide"
],
"type": "string"
},
"max_price": {
"description": "Maximum price filter",
"minimum": 0,
"type": "number"
},
"min_price": {
"description": "Minimum price filter",
"minimum": 0,
"type": "number"
},
"page": {
"default": 1,
"description": "Result page number; follow next_page from a previous response",
"minimum": 1,
"type": "integer"
},
"per_page": {
"default": 50,
"description": "Results per page",
"enum": [
25,
50,
100,
200
],
"type": "integer"
},
"query": {
"description": "Free-text search query — anything usable in a regular eBay search (e.g. \"iphone 15 pro\")",
"maxLength": 300,
"type": "string"
},
"sort": {
"default": "best_match",
"description": "Sort order",
"enum": [
"best_match",
"ending_soonest",
"newly_listed",
"price_shipping_lowest",
"price_shipping_highest",
"distance_nearest"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"categories": {
"description": "Category facets; pass an id back as category_id to narrow the search",
"items": {
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"domain": {
"description": "eBay site actually searched",
"type": "string"
},
"items": {
"items": {
"properties": {
"bids": {
"description": "Auction bid count",
"type": "integer"
},
"condition": {
"type": "string"
},
"details_link": {
"description": "This API's /product URL for the listing",
"type": "string"
},
"discount": {
"description": "Discount label, e.g. \"18% off\"",
"type": "string"
},
"extensions": {
"description": "Listing badges (e.g. \"Free returns\")",
"items": {
"type": "string"
},
"type": "array"
},
"link": {
"description": "The listing's eBay page",
"type": "string"
},
"location": {
"description": "Where the item ships from",
"type": "string"
},
"original_price": {
"description": "Pre-discount price, when the listing is discounted",
"properties": {
"extracted": {
"type": "number"
},
"raw": {
"type": "string"
}
},
"type": "object"
},
"price": {
"description": "Listing price; a from/to range flattens to the range string plus the extracted low bound",
"properties": {
"extracted": {
"type": "number"
},
"raw": {
"type": "string"
}
},
"type": "object"
},
"product_id": {
"description": "eBay item id — pass to /product for the full listing",
"type": "string"
},
"quantity_sold": {
"type": "integer"
},
"rating": {
"type": "number"
},
"returns": {
"type": "string"
},
"reviews_count": {
"type": "integer"
},
"seller": {
"properties": {
"positive_feedback_percent": {
"type": "number"
},
"review_count": {
"type": "integer"
},
"username": {
"type": "string"
}
},
"type": "object"
},
"shipping": {
"description": "Shipping cost line",
"properties": {
"extracted": {
"type": "number"
},
"free": {
"type": "boolean"
},
"raw": {
"type": "string"
}
},
"type": "object"
},
"sold_date": {
"description": "Realized sale date — set on /sold results when the upstream marks it",
"type": "string"
},
"sponsored": {
"type": "boolean"
},
"subtitle": {
"type": "string"
},
"thumbnail": {
"type": "string"
},
"time_left": {
"description": "Auction time remaining",
"type": "string"
},
"title": {
"type": "string"
},
"watchers": {
"type": "integer"
}
},
"type": "object"
},
"type": "array"
},
"next_page": {
"description": "Pass back as page= for the next page; null when this is the last page",
"type": [
"integer",
"null"
]
},
"note": {
"description": "Present only on a sample response (empty/omitted query): a hint to pass real parameters. The paid request ran; no upstream call was made.",
"type": "string"
},
"page": {
"type": "integer"
},
"per_page": {
"type": "integer"
},
"query": {
"description": "Echoed search query",
"type": "string"
},
"related_searches": {
"description": "Suggested query refinements",
"items": {
"type": "string"
},
"type": "array"
},
"total_results": {
"description": "Total listings matching the query upstream",
"type": "integer"
}
},
"required": [
"query",
"domain",
"page",
"per_page",
"items"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
},
"tags": [
"ebay",
"ecommerce",
"marketplace",
"shopping",
"prices",
"sold-comps",
"products"
]
}
}Use it
curl
curl "https://ebay.use.x402atlas.com/search" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://ebay.use.x402atlas.com/search");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://ebay.use.x402atlas.com/search")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/4495.json, and this resource appears in /discovery/resources and /discovery/search.