ebay-api-ruby 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b23fa2381e44c43e7d349a5d214f382385c78589f146474a973e83f5856374c
-  data.tar.gz: 03134117bb7a380db73b022cfe61a0dd0d8b92b46cc9aaa02b3d2b5aeb944969
+  metadata.gz: ca9bfb12653bedb4b382524b74f64351f54090af81c77aa904ddf56bd79e3622
+  data.tar.gz: 689b373e5c06a0eacc4c208abcce936c1bc4133beaf33604a19d674a17df0211
 SHA512:
-  metadata.gz: 0bdbd6383759a9d35afcad66b261e5ac619b2db715a6ba9d617cc3c096869820e10249a1de30559065590360e27e30200e1590fa56261429ace3b0a1933a00c6
-  data.tar.gz: 75ddb7fffeef6a2ee863d0a91a09a414074527d0dcd5fef4525b6911f8cbac8ab810b0fa922136f0fde3e7ebaacab9305bea91e6a45774514241ba0a3d622615
+  metadata.gz: 143f878b8ef05a3b51198a44aae4cc3a74b2457efbecca5fd36c97e19cc86cb06efa2f894f178675d32427ce69d513d827566de310bea150d95ae596a761f4e8
+  data.tar.gz: 556411ffe901a48604126121fa21c5dcf1f10797b3edc10833286c9fd3d0350308055821a2d3043a72d5c879a20ece5890b064ff356ae82a27534f275f41703a

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.0] - 2026-03-26
+
+### Added
+
+- Marketplace Insights API: `Ebay::MarketplaceInsights#search` for sold/completed item data
+- Browse API: `Ebay::Browse#search_by_category` for category-only searches
+
+### Deprecated
+
+- Finding API: all methods deprecated — eBay has shut down the Finding Service
+  - `find_items_by_keywords` → use `Ebay::Browse#search`
+  - `find_completed_items` → use `Ebay::MarketplaceInsights#search`
+  - `find_items_by_category` → use `Ebay::Browse#search_by_category`
+  - `find_items_advanced` → use `Ebay::Browse#search`
+- Configuration: `app_id` is deprecated (OAuth 2.0 only going forward)
+
 ## [0.1.0] - 2026-03-26
 
 ### Added

data/README.md

@@ -1,6 +1,8 @@
 # ebay-api-ruby
 
-A modern Ruby gem for the eBay REST APIs. Supports the Browse API, Finding API, and Taxonomy API with OAuth 2.0 authentication.
+A modern Ruby gem for the eBay REST APIs. Supports the Browse API, Marketplace Insights API, and Taxonomy API with OAuth 2.0 authentication.
+
+> **Deprecation Notice:** The eBay Finding API has been shut down. All `Ebay::Finding` methods now emit deprecation warnings and will be removed in v1.0.0. See [Migration Guide](#migrating-from-the-finding-api) below.
 
 ## Installation
 
@@ -30,7 +32,6 @@ require 'ebay'
 Ebay.configure do |config|
   config.client_id = ENV['EBAY_CLIENT_ID']
   config.client_secret = ENV['EBAY_CLIENT_SECRET']
-  config.app_id = ENV['EBAY_APP_ID']           # Optional, defaults to client_id for Finding API
   config.marketplace_id = 'EBAY_US'             # Default
   config.timeout = 30                            # Default
 end
@@ -67,29 +68,33 @@ item = browse.get_item("v1|123456789|0")
 # Get items by group
 items = browse.get_items_by_item_group("group123")
 
+# Search by category (no keywords required)
+results = browse.search_by_category("9355", limit: 10)
+
 # Search by image
 results = browse.search_by_image(Base64.encode64(File.read("watch.jpg")))
 ```
 
-### Finding API
+### Marketplace Insights API
 
-Search active and completed/sold listings. Uses the legacy Finding Service (no OAuth required, just app_id).
+Search sold/completed items for price history and market data.
 
 ```ruby
-finding = Ebay::Finding.new
+insights = Ebay::MarketplaceInsights.new
 
-# Search by keywords
-results = finding.find_items_by_keywords("macbook pro m3")
+# Search sold items
+sold = insights.search(q: "pokemon base set charizard")
+sold['itemSales'].each do |item|
+  puts "#{item['title']} - sold for #{item['lastSoldPrice']['value']}"
+end
 
-# Find completed/sold items (great for price history)
-sold = finding.find_completed_items("pokemon base set charizard")
+# With filters
+sold = insights.search(q: "vintage rolex", category_ids: "31387", limit: 20)
+```
 
-# Advanced search with filters
-results = finding.find_items_advanced(keywords: "nike jordan", categoryId: "93427")
+### Finding API (Deprecated)
 
-# Search by category
-results = finding.find_items_by_category("9355")
-```
+> **The Finding API has been shut down by eBay.** All methods emit deprecation warnings. Use Browse and Marketplace Insights APIs instead. See [Migration Guide](#migrating-from-the-finding-api).
 
 ### Taxonomy API
 
@@ -144,6 +149,22 @@ rescue Ebay::ConfigurationError => e
 end
 ```
 
+## Migrating from the Finding API
+
+The eBay Finding API has been shut down. Here's how to migrate to the replacement APIs:
+
+| Finding (old) | Replacement (new) |
+|---|---|
+| `finding.find_items_by_keywords("query")` | `browse.search(q: "query")` |
+| `finding.find_completed_items("query")` | `insights.search(q: "query")` |
+| `finding.find_items_by_category("9355")` | `browse.search_by_category("9355")` |
+| `finding.find_items_advanced(keywords: "q", categoryId: "9355")` | `browse.search(q: "q", category_ids: "9355")` |
+
+**Key differences:**
+- **Auth:** No more `app_id` — all APIs use OAuth 2.0 (`client_id` + `client_secret`)
+- **Response format:** Clean REST JSON instead of the old nested XML-style format
+- **Filters:** Browse API uses a `filter` parameter (e.g., `filter: "price:[10..50],priceCurrency:USD"`) instead of Finding's `itemFilter` syntax
+
 ## Development
 
 ```bash

data/lib/ebay/browse.rb

@@ -16,6 +16,10 @@ module Ebay
       client.get("/buy/browse/v1/item/get_items_by_item_group", item_group_id: item_group_id)
     end
 
+    def search_by_category(category_ids, **params)
+      client.get("/buy/browse/v1/item_summary/search", { category_ids: category_ids }.merge(params))
+    end
+
     def search_by_image(image_base64, **params)
       client.post("/buy/browse/v1/item_summary/search_by_image", { image: image_base64 }.merge(params))
     end

data/lib/ebay/configuration.rb

@@ -2,8 +2,15 @@
 
 module Ebay
   class Configuration
-    attr_accessor :client_id, :client_secret, :app_id,
+    attr_accessor :client_id, :client_secret,
                   :base_url, :sandbox, :timeout, :marketplace_id
+    attr_reader :app_id
+
+    def app_id=(value)
+      warn "[DEPRECATION] app_id is deprecated. The Finding API has been shut down by eBay. " \
+           "Use client_id and client_secret with OAuth 2.0 instead (Browse and Marketplace Insights APIs)."
+      @app_id = value
+    end
 
     def initialize
       @base_url = "https://api.ebay.com"
@@ -24,6 +31,7 @@ module Ebay
     end
 
     def finding_url
+      warn "[DEPRECATION] finding_url is deprecated. The Finding API has been shut down by eBay."
       sandbox ? "https://svcs.sandbox.ebay.com/services/search/FindingService/v1" : "https://svcs.ebay.com/services/search/FindingService/v1"
     end
   end

data/lib/ebay/finding.rb

@@ -3,18 +3,30 @@
 module Ebay
   class Finding < Base
     def find_items_by_keywords(keywords, **params)
+      warn "[DEPRECATION] Ebay::Finding#find_items_by_keywords is deprecated. " \
+           "Use Ebay::Browse#search(q: keywords) instead. " \
+           "The Finding API has been shut down by eBay."
       finding_request("findItemsByKeywords", { keywords: keywords }.merge(params))
     end
 
     def find_completed_items(keywords, **params)
+      warn "[DEPRECATION] Ebay::Finding#find_completed_items is deprecated. " \
+           "Use Ebay::MarketplaceInsights#search(q: keywords) instead. " \
+           "The Finding API has been shut down by eBay."
       finding_request("findCompletedItems", { keywords: keywords }.merge(params))
     end
 
     def find_items_advanced(**params)
+      warn "[DEPRECATION] Ebay::Finding#find_items_advanced is deprecated. " \
+           "Use Ebay::Browse#search(q:, category_ids:, ...) instead. " \
+           "The Finding API has been shut down by eBay."
       finding_request("findItemsAdvanced", params)
     end
 
     def find_items_by_category(category_id, **params)
+      warn "[DEPRECATION] Ebay::Finding#find_items_by_category is deprecated. " \
+           "Use Ebay::Browse#search_by_category(category_ids) instead. " \
+           "The Finding API has been shut down by eBay."
       finding_request("findItemsByCategory", { categoryId: category_id }.merge(params))
     end
 

data/lib/ebay/marketplace_insights.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Ebay
+  class MarketplaceInsights < Base
+    def search(q:, **params)
+      client.get("/buy/marketplace_insights/v1_beta/item_sales/search", { q: q }.merge(params))
+    end
+  end
+end

data/lib/ebay/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ebay
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/ebay.rb

@@ -11,6 +11,7 @@ require_relative 'ebay/client'
 require_relative 'ebay/base'
 require_relative 'ebay/browse'
 require_relative 'ebay/finding'
+require_relative 'ebay/marketplace_insights'
 require_relative 'ebay/taxonomy'
 
 module Ebay

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ebay-api-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Eduardo Souza
@@ -154,6 +154,7 @@ files:
 - lib/ebay/configuration.rb
 - lib/ebay/errors.rb
 - lib/ebay/finding.rb
+- lib/ebay/marketplace_insights.rb
 - lib/ebay/taxonomy.rb
 - lib/ebay/version.rb
 homepage: https://github.com/esouza/ebay-api-ruby