naftiko: 1.0.0-alpha2 info: label: eBay Marketplace Insights API — Item_sales description: 'eBay Marketplace Insights API — Item_sales. 1 operations. Lead operation: Item_sales. Self-contained Naftiko capability covering one Ebay business surface.' tags: - Ebay - Item_sales created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: EBAY_API_KEY: EBAY_API_KEY capability: consumes: - type: http namespace: marketplace-insights-item-sales baseUri: https://api.ebay.com{basePath} description: eBay Marketplace Insights API — Item_sales business capability. Self-contained, no shared references. resources: - name: item_sales-search path: /item_sales/search operations: - name: search method: GET description: Note: This is a Limited Release outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: aspect_filter in: query type: string description: This query parameter lets you filter by item aspects. The aspect name/value pairs and category, which is required, is used to limit the results to specific aspe - name: category_ids in: query type: string description: This query parameter specifies the category ID used to limit the result set. For example, if you search for 'shirt' the result set will be very large. But if yo - name: epid in: query type: string description: The ePID is the eBay product identifier of a product from the eBay product catalog. This query parameter limits the results to only items in the specified ePID. - name: fieldgroups in: query type: string description: This query parameter lets you control what is to be returned in the response and accepts a comma separated list of values.

The default is MATCHING_I - name: filter in: query type: string description: 'This query parameter supports multiple field filters that can be used to limit/customize the result set.

The following lists the supported filters. For ' - name: gtin in: query type: string description: This query parameter lets you search by the Global Trade Item Number of the item as defined by https://www.gtin - name: limit in: query type: string description: This query parameter specifies the number of items from the result set returned in a single page.

Note: If a value is set - name: offset in: query type: string description: 'This query parameter 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. ' - name: q in: query type: string description: A string consisting of one or more keywords that are used to search for items on eBay. The keywords are handled as follows: