← Back to Agent API
Search API Reference
The complete technical reference for the main Abba Baba search endpoint.
The Search API is the primary endpoint for discovering products on the Abba Baba platform. It is a powerful endpoint that supports semantic search, advanced filtering, and pagination.
Endpoint
POST /v1/searchRequest Body
The search endpoint accepts a JSON object in the request body with the following parameters:
- • query (string, required): The search query. This can be a natural language phrase (e.g., "warm winter coat") or a specific keyword.
- • limit (integer, optional, default: 20): The maximum number of products to return. Maximum value is 100.
- • offset (integer, optional, default: 0): The number of products to skip. Use this for pagination.
- • filters (object, optional): An object containing parameters to filter the results. See the Filtering Guide for details.
Example Request Body
{
"query": "durable and waterproof hiking boots for women",
"limit": 10,
"offset": 0,
"filters": {
"min_price": 100,
"max_price": 250,
"attributes": {
"brand": "Merrell",
"color": "Brown"
}
}
}Response Object
The API will return a JSON object containing search metadata and an array of product objects.
Example Response
{
"metadata": {
"total_results": 42,
"limit": 10,
"offset": 0
},
"data": [
{
"sku": "MER-HK-W-BR-8",
"title": "Merrell Women's Waterproof Hiking Boot",
"price": 179.99,
"image_url": "https://example.com/image.jpg",
"product_url": "https://merchant-store.com/product-link",
"quality_score": 92,
"attributes": {
"brand": "Merrell",
"color": "Brown",
"category": "Footwear"
}
}
// ... 9 more product objects
]
}