---
openapi: 3.1.0
info:
  title: eBay Search — SearchApi
  version: 3.1.0
  description: Generated from the SearchApi engine catalog. Parameters marked in the
    catalog as unverified are described from its records rather than from the vendor's
    specification.
servers:
- url: https://www.searchapi.io/api/v1
paths:
  "/search":
    get:
      operationId: ebay_search
      summary: eBay Search
      parameters:
      - name: engine
        in: query
        required: true
        description: Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE
          keys).
        schema:
          type: string
          const: ebay_search
      - name: api_key
        in: query
        required: true
        description: 'SearchApi.io API key; alternatively send ''Authorization: Bearer
          <key>''.'
        schema:
          type: string
      - name: zero_retention
        in: query
        required: false
        description: 'Enterprise-only: disables all logging and persistent storage
          of the search.'
        schema:
          type: boolean
          default: false
      - name: q
        in: query
        required: true
        description: Search query; most engines accept native operators and advanced
          filters.
        schema:
          type: string
      - name: ebay_domain
        in: query
        required: false
        description: eBay marketplace domain to query, e.g. ebay.com, ebay.de.
        schema:
          type: string
          default: ebay.com
      - name: buying_format
        in: query
        required: false
        description: Buying format filter.
        schema:
          type: string
          enum:
          - all
          - auction
          - buy_it_now
          - accepts_offers
      - name: condition
        in: query
        required: false
        description: Item condition filter, e.g. new, used, open_box.
        schema:
          type: string
      - name: price_min
        in: query
        required: false
        description: Minimum price filter.
        schema:
          type: integer
      - name: price_max
        in: query
        required: false
        description: Maximum price filter.
        schema:
          type: integer
      - name: sort_by
        in: query
        required: false
        description: Order of the results, e.g. best_match, price_asc, price_desc.
        schema:
          type: string
      - name: page
        in: query
        required: false
        description: Page number of the results.
        schema:
          type: integer
          default: 1
      responses:
        '200':
          description: A eBay Search result envelope.
