ebay-api-ruby

gem 'ebay-api-ruby'

require 'ebay'

Ebay.configure do |config|
  config.client_id = ENV['EBAY_CLIENT_ID']
  config.client_secret = ENV['EBAY_CLIENT_SECRET']
  config.marketplace_id = 'EBAY_US'             # Default
  config.timeout = 30                            # Default
end

Ebay.configure do |config|
  config.client_id = ENV['EBAY_SANDBOX_CLIENT_ID']
  config.client_secret = ENV['EBAY_SANDBOX_CLIENT_SECRET']
  config.sandbox!
end

browse = Ebay::Browse.new

# Search items
results = browse.search(q: "vintage rolex", limit: 10)
results['itemSummaries'].each do |item|
  puts "#{item['title']} - #{item['price']['value']} #{item['price']['currency']}"
end

# Get a specific item
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")))

insights = Ebay::MarketplaceInsights.new

# 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

# With filters
sold = insights.search(q: "vintage rolex", category_ids: "31387", limit: 20)

taxonomy = Ebay::Taxonomy.new

# Get default category tree ID for a marketplace
tree_info = taxonomy.get_default_category_tree_id("EBAY_US")
tree_id = tree_info['categoryTreeId']

# Get the full category tree
tree = taxonomy.get_category_tree(tree_id)

# Get a subtree
subtree = taxonomy.get_category_subtree(tree_id, "9355")

client = Ebay.client

# Manual authentication (usually not needed)
client.authenticate!

# Direct API calls
result = client.get("/buy/browse/v1/item_summary/search", q: "test")
result = client.post("/some/endpoint", { data: "value" })

begin
  browse.search(q: "test")
rescue Ebay::AuthenticationError => e
  puts "Auth failed: #{e.message}"
rescue Ebay::NotFoundError => e
  puts "Not found: #{e.message} (#{e.status_code})"
rescue Ebay::RateLimitError => e
  puts "Rate limited. Retry after: #{e.retry_after}"
rescue Ebay::ValidationError => e
  puts "Validation error: #{e.errors}"
rescue Ebay::APIError => e
  puts "API error: #{e.message} (#{e.status_code})"
rescue Ebay::ConfigurationError => e
  puts "Config error: #{e.message}"
end