api_agent_commerce_hunter
Read-onlyIdempotent
Agent Commerce Hunter — Search customer-authorized eBay offers OR inspect one caller-supplied public product page without an eBay key when source_mode=public_page; compare prices only for actual offers, and optionally read stock signals through extract/product-check, retrieve published return-policy excerpts and calculate order contribution using caller-supplied sale price and goods cost. One x402 charge covers the composed workflow; missing evidence remains explicit. One call costs 0.01 USDC on Base x402; customer-owned provider credentials use X-Provider-Key header where needed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum listings 1–20 | |
| query | Yes | Exact product model or sourcing query; eBay search requires X-Provider-Key, public_page does not | |
| orders | No | Optional number of orders | |
| currency | No | Same ISO currency code for all profit figures, required when profit is requested | |
| unit_cost | No | Customer known goods cost per order; required with selling_price | |
| policy_url | No | Optional public returns policy page; text excerpts, not eligibility decision | |
| marketplace | No | eBay marketplace ID, e.g. EBAY_US | |
| source_mode | No | Optional ebay (default) or public_page; public_page requires comparison_url and does not search marketplace offers | |
| ads_per_order | No | Optional attributed advertising per order | |
| selling_price | No | Customer assumed selling price per order; required with unit_cost | |
| shipping_cost | No | Optional per-order shipping and packing cost | |
| comparison_url | No | Optional public product page for product-check and extract stock signals | |
| platform_fee_pct | No | Optional percentage fee on selling price |