Browse Products
The Browse API allows agents to search across all merchants for products without needing a specific domain.
Unlike other agent routes, this endpoint does not go through domain validation and is globally accessible.
Endpoint
GET /agent/browse/
This route supports optional filters to refine search results, including price range and title search.
---
## Query Parameters
| Parameter | Type | Description | Example |
|----------------|--------|---------------------------------------------|---------------------|
| `min_price` | float | Minimum price to include in results | `10.0` |
| `max_price` | float | Maximum price to include in results | `100.0` |
| `description` | string | Search products by title (case-insensitive) | `sneakers` |
| `limit` | int | Number of results to return (max 100) | `20` |
---
Example Request
Browse products globally
curl "https://api.waltacheckout.com/agent/browse?min_price=20&max_price=100&description=shirt&limit=5"
Example Response
json
Copy
Edit
{
"products": [
{
"id": "3e1b07da-9d0a-4e5b-9cbe-abc123",
"company_name": "store-alpha",
"title": "Cotton Shirt",
"cost": 29.99,
"other_specs": { "color": "blue", "size": "M" },
"created_at": "2025-08-01T12:34:56Z",
"updated_at": "2025-08-01T12:34:56Z"
},
{
"id": "ba8f412e-3f5b-4763-9c1e-xyz789",
"company_name": "store-beta",
"title": "Linen Shirt",
"cost": 45.00,
"other_specs": { "color": "white", "size": "L" },
"created_at": "2025-08-02T09:15:32Z",
"updated_at": "2025-08-02T09:15:32Z"
}
],
"count": 2
}
Features
- Global Search: Agents can query products from all merchants without needing a specific domain.
- Filter Support: Search by price range, product title, or both.
- Performance: Supports limiting results (default 50, max 100) for efficient queries.
- No Domain Required: This endpoint is excluded from domain validation middleware.
Use Cases
- Agents discovering products across multiple stores before selecting where to buy.
- Implementing recommendation or comparison logic in agent workflows.
- Testing global product availability without merchant-specific context.