naftiko: 1.0.0-alpha2 info: label: eBay Browse API — Item_summary description: 'eBay Browse API — Item_summary. 2 operations. Lead operation: Item_summary. Self-contained Naftiko capability covering one Ebay business surface.' tags: - Ebay - Item_summary created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: EBAY_API_KEY: EBAY_API_KEY capability: consumes: - type: http namespace: browse-item-summary baseUri: https://api.ebay.com{basePath} description: eBay Browse API — Item_summary business capability. Self-contained, no shared references. resources: - name: item_summary-search path: /item_summary/search operations: - name: search method: GET description: This method searches for eBay items by various query parameters and retrieves summaries of the items. You can search by keyword, category, eBay product ID (ePID), or GTIN, charity ID, or a combination of these.

The category ID is used to limit the results that are returned. This field may pass in one category ID or a comma separated list of I - name: charity_ids in: query type: string description: The charity ID filters results to return only those items associated with the specified charity.

Note:

charity_ids
Us
        - name: fieldgroups
          in: query
          type: string
          description: 'A comma-separated list of values that controls what is returned in the response. The default is MATCHING_ITEMS,
            which returns the items that match '
        - name: filter
          in: query
          type: string
          description: An array of field filters that can be used to limit/customize the result set.

Refer to https://www.gtin.info.<
        - name: limit
          in: query
          type: string
          description: The number of items from the result set returned in a single page.

Note:
            If a value is set in the limit field
        - name: offset
          in: query
          type: string
          description: Specifies the number of items to skip in the result set. This is used with the limit field
            to control the pagination of the output.

For exam
        - name: q
          in: query
          type: string
          description: 'A string consisting of one or more keywords used to search for items on eBay.

Note:
            The * wildcard character '
        - name: sort
          in: query
          type: string
          description: Specifies the criteria on which returned items are to be sorted.

Items can be sorted in ascending
            order based on:Price (sort=price)<
        - name: X-EBAY-C-ENDUSERCTX
          in: header
          type: string
          description: This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy
            of shipping and delivery time estimations.

For ad
        - name: X-EBAY-C-MARKETPLACE-ID
          in: header
          type: string
          description: This header identifies the seller's eBay marketplace. It is required for all marketplaces outside of
            the US.

Note: If a ma
        - name: Accept-Language
          in: header
          type: string
          description: This header is used to indicate the natural language and locale preferred by the user for the response.

This
            header is required when targeting a specific
    - name: item_summary-search_by_image
      path: /item_summary/search_by_image
      operations:
      - name: searchbyimage
        method: POST
        description: Note:  This is an Note: charity_idsMATCHING_ITEMS,
            which returns the items that match '
        - name: filter
          in: query
          type: string
          description: An array of field filters that can be used to limit/customize the result set.

Refer to 
Note:
            If a value is set in the limit field
        - name: offset
          in: query
          type: string
          description: Specifies the number of items to skip in the result set. This is used with the limit field
            to control the pagination of the output.

For exam
        - name: sort
          in: query
          type: string
          description: 'Note: This call currently returns results in a best-match order. This
            query parameter presently has no practical use. For '
        - name: X-EBAY-C-ENDUSERCTX
          in: header
          type: string
          description: This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy
            of shipping and delivery time estimations.

For ad
        - name: X-EBAY-C-MARKETPLACE-ID
          in: header
          type: string
          description: This header identifies the seller's eBay marketplace. It is required for all marketplaces outside of
            the US.

Note: If a ma
        - name: Content-Type
          in: header
          type: string
          description: This header indicates the format of the request body provided by the client. Its value should be set
            to application/json.

For more informati
          required: true
        - name: Accept-Language
          in: header
          type: string
          description: This header is used to indicate the natural language and locale preferred by the user for the response.

This
            header is required when targeting a specific
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: browse-item-summary-rest
    port: 8080
    description: REST adapter for eBay Browse API — Item_summary. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/item-summary/search
      name: item-summary-search
      description: REST surface for item_summary-search.
      operations:
      - method: GET
        name: search
        description: This method searches for eBay items by various query parameters and retrieves summaries of the items.
          You can search by keyword, category, eBay product ID (ePID), or GTIN, charity ID, or a combination of these.

Note:  This is an Note:  This is an