Docs/AJIO Products
Docs / API reference
POST/v1/data/ajio/products
AJIO Products
Search AJIO products by query or category refinements. Returns normalized product rows with SKU, brand, category, segment, price, list price, discount, rating, coupon, badges, and merchandising attributes.
Execution model
Live request
Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.
Credit weight
Live catalog
Current weights are managed from the Data API Weights admin table and shown on pricing before use.
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
| query | string | Optional | Product search query. Required unless queries, category, or subcategory is supplied. |
| queries | string[] | Optional | Optional batch-style terms. The first term is used by this endpoint. |
| category | string | Optional | Top-level AJIO category/refinement. |
| subcategory / subcategorySlug | string | Optional | Deeper category/search refinement. |
| min_price / minPrice | number | Optional | Minimum price in INR. |
| max_price / maxPrice | number | Optional | Maximum price in INR. |
| num_results / maxResults | number | Optional | Maximum products to return (1-200). |
| page | number | Optional | Starting page (1-20). |
| sort_by / sortBy | string | Optional | Sort order: relevance, popularity, discount, price_low, price_high, newest, rating. Common price-asc/price-desc aliases are accepted. |
| timeout_ms | number | Optional | Provider timeout in milliseconds (3000-60000). |
Response fields
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the AJIO request completed successfully. |
| products | array | Product rows with product_id, SKU, title, brand, category, segment, URL, image, price, list price, discount, rating, coupon, and badges. |
| total_results / total_pages | number | Pagination counts when available. |
| pages_fetched | number | Number of pages fetched. |
| time_taken | number | API response time in seconds. |
Request and response
curl -X POST "https://api.datablue.dev/v1/data/ajio/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "lipstick",
"maxResults": 10,
"sortBy": "discount"
}'Example response
{
"success": true,
"source": "ajio",
"query": "lipstick",
"sort_by": "discount",
"page": 1,
"total_results": 120,
"pages_fetched": 1,
"time_taken": 1.36,
"products": [
{
"position": 1,
"product_id": "460000001",
"sku": "SKU123",
"title": "Matte Lipstick",
"brand": "Example Beauty",
"category": "Beauty",
"url": "https://www.ajio.com/example/p/460000001",
"price": 399,
"list_price": 799,
"currency": "INR",
"discount": "50% off",
"rating": 4.1,
"rating_count": 340
}
]
}