Api Endpoint

eBay Search & Products

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.

Open interactive test console

Offering

Provider
ebay.use.x402atlas.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Business And Commerce
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://ebay.use.x402atlas.com/search
MIME type
application/json
First seen
2026-10-16T01:50:10.647Z
Last seen
Tags
ebay, ecommerce, marketplace, shopping, Prices, products

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.02 USDC
Atomic price: 20000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 3
0.02 USDC
Atomic price: 20000 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Payment option 4
0.02 USDC
Atomic price: 20000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "20000",
    "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "20000",
    "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "20000",
    "payTo": "ASt6xvRyQ7ntERsmcYVMdLqZvz1GEN8Fzexzq62tXrNQ"
  }
]

Observed health

Status
Healthy
Latest latency
17 ms
Average latency
105 ms
HTTP status
402
Last checked
Reachability
100% over 11 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "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 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"
                  },
                  "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"
}