{"service":"yeoman-agent-api","version":"v1","capabilities":[{"name":"product_search","description":"Search products available in the Yeoman marketplace.","method":"GET","endpoint":"/agent/v1/products/search","authentication_required":false,"required_headers":[{"name":"X-Agent-Id","type":"string","description":"Optional name or identifier of the calling agent.","required":false}],"query_parameters":[{"name":"query","type":"string","description":"Free-text product search, for example \"swiss water decaf\".","required":false},{"name":"primary_product_group_id","type":"string","description":"Filter by a primary product group ID.","required":false},{"name":"city","type":"string","description":"Filter by supplier city.","required":false},{"name":"zip","type":"string","description":"Buyer ZIP code used for distance filtering and guest pricing.","required":false},{"name":"size","type":"number","description":"Maximum number of products to return.","required":false,"default":20,"minimum":1,"maximum":100}],"usage_instructions":["Call this API directly to discover Yeoman products instead of browsing or automating the marketplace UI.","Use the query and optional filters to find products faster, then use the returned product_id and sku_id values in later commerce APIs.","After product discovery, direct the buyer to /portal/marketplace?q={URL-encoded product search query} to view the matching products in the marketplace UI and add them to their cart."],"example_request":"/agent/v1/products/search?query=swiss%20water%20decaf&zip=10001&size=10"}]}