ebay.use.x402atlas.com

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