Nexez Agentic Commerce

{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Optional case-insensitive text filter across listing name, description, audience, and location.'}, 'category': {'enum': ['all', 'professional', 'consumer'], 'type': 'string', 'description': 'Marketplace category; defaults to all.'}, 'location': {'type': 'string', 'description': 'Optional city or region filter matched against published location and service-area information.'}, 'min_readiness': {'type': 'number', 'description': 'Minimum listing readiness score, normally 0-100; defaults to 0 (no threshold).'}}}

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Exact published listing slug returned by nexez_search or nexez_directory, not a full URL.'}}}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'What the buyer is looking for'}, 'lat': {'type': 'number', 'description': 'Optional latitude context metadata. Does not filter or rerank results; use location for geographic filtering.'}, 'lng': {'type': 'number', 'description': 'Optional longitude context metadata. Does not filter or rerank results; use location for geographic filtering.'}, 'limit': {'type': 'number', 'description': 'Maximum results; defaults to 10 and is rounded down and clamped to 1-50.'}, 'category': {'enum': ['all', 'professional', 'consumer'], 'type': 'string', 'description': 'Marketplace category; omit or use all to include both professional and consumer listings.'}, 'industry': {'type': 'string', 'description': 'Case-insensitive substring filter on the published industry, for example plumbing.'}, 'location': {'type': 'string', 'description': 'Optional city/region filter'}, 'verified': {'type': 'boolean', 'description': 'Filter by seller verification signal: true requires a signal, false requires its absence; omit to include both.'}, 'min_trust': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Minimum marketplace trust score (0-100); omit for no trust threshold. Not a guarantee of seller performance.'}, 'price_band': {'enum': ['free', 'under_100', '100_500', '500_2000', '2000_plus', 'custom'], 'type': 'string', 'description': 'Filter by the listing marketplace price band. Inspect the exact offer for its price and currency; this is not a checkout quote.'}, 'min_readiness': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Minimum listing readiness score (0-100); omit for no readiness threshold.'}, 'supports_checkout': {'type': 'boolean', 'description': 'Deprecated compatibility filter: any actionable offer or provider handoff'}, 'nexez_checkout_ready': {'type': 'boolean', 'description': 'Owner payout state confirms Nexez-settled checkout readiness'}, 'supports_negotiation': {'type': 'boolean', 'description': 'Filter by negotiation availability: true for eligible listings, false for non-negotiable listings; omit to include both.'}}}

{'type': 'object', 'required': ['slug', 'offer'], 'properties': {'slug': {'type': 'string', 'description': 'Exact published listing slug returned by discovery, not a full URL.'}, 'offer': {'type': 'string', 'description': 'Exact offer key from the listing manifest, for example services-0 or products-1. Do not invent an index.'}, 'query': {'type': 'string', 'description': 'Optional buyer context'}, 'buyerEmail': {'type': 'string', 'description': 'Optional buyer-provided email for checkout context. Omit when unnecessary; never invent personal details.'}, 'buyerReference': {'type': 'string', 'description': 'Optional buyer-provided reference for checkout context; omit if none was supplied.'}, 'offerConfiguration': {'type': 'object', 'description': 'Buyer-selected configuration values keyed exactly as defined by the target offer configuration schema from nexez_get_page. Supply required fields for that offer; do not invent values or use a generic schema.'}}}

{'type': 'object', 'required': ['slug', 'offer'], 'properties': {'slug': {'type': 'string', 'description': 'Exact published listing slug returned by discovery, not a full URL.'}, 'offer': {'type': 'string', 'description': 'Exact offer key from the listing manifest, for example services-0 or products-1.'}, 'query': {'type': 'string', 'description': 'Buyer request describing the desired work or product and relevant context.'}, 'budget': {'type': 'string', 'description': 'Buyer-proposed budget or range as text, using the offer currency, for example USD 500. Do not invent a budget.'}, 'contact': {'type': 'string', 'description': 'Optional buyer contact route.'}, 'timeline': {'type': 'string', 'description': 'Buyer-proposed delivery timing as text, for example within 4 weeks. Use requestedTerms.projectWeeks for a numeric duration rule.'}, 'requestedTerms': {'type': 'object', 'description': 'Structured buyer proposal. Published seller rules may require scope (text or list of deliverables), revisionCount (whole number 0-1000), and projectWeeks (whole number 1-1000). Example: {"scope":"Logo and brand guide","revisionCount":2,"projectWeeks":4}. Inspect the offer rules; omit unknown terms rather than inventing them.'}}}