API ReferenceAgent
Search products
Search the Channel3 product catalog within the mandate's currency and remaining budget (discovery only; never pays)
Authorization
agent AuthorizationBearer <token>
Per-agent API key from POST /v1/agents
In: header
Request Body
application/json
mandate_id*string
query*string
limit?integer
1-30, default 8
page_token?string
next_page_token from a previous search
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agent/products/search" \ -H "Content-Type: application/json" \ -d '{ "mandate_id": "string", "query": "string" }'{ "provider": "string", "mandate_id": "string", "query": "string", "max_price": "string", "currency": "string", "products": [ { "product_id": "string", "channel3_id": "string", "title": "string", "brand": "string", "image": "string", "category": "string", "offers": [ { "domain": "string", "url": "string", "price": "string", "price_minor": 0, "currency": "string", "availability": "string", "condition": "string" } ], "best_offer": { "domain": "string", "url": "string", "price": "string", "price_minor": 0, "currency": "string", "availability": "string", "condition": "string" }, "mandate_fit": { "fits": true, "needs_approval": true, "checks": [ { "check": "string", "pass": true, "detail": "string" } ] } } ], "next_page_token": "string", "how_to_pay": "string"}