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

NameTypeRequirementDescription
querystringOptionalProduct search query. Required unless queries, category, or subcategory is supplied.
queriesstring[]OptionalOptional batch-style terms. The first term is used by this endpoint.
categorystringOptionalTop-level AJIO category/refinement.
subcategory / subcategorySlugstringOptionalDeeper category/search refinement.
min_price / minPricenumberOptionalMinimum price in INR.
max_price / maxPricenumberOptionalMaximum price in INR.
num_results / maxResultsnumberOptionalMaximum products to return (1-200).
pagenumberOptionalStarting page (1-20).
sort_by / sortBystringOptionalSort order: relevance, popularity, discount, price_low, price_high, newest, rating. Common price-asc/price-desc aliases are accepted.
timeout_msnumberOptionalProvider timeout in milliseconds (3000-60000).

Response fields

FieldTypeDescription
successbooleanWhether the AJIO request completed successfully.
productsarrayProduct rows with product_id, SKU, title, brand, category, segment, URL, image, price, list price, discount, rating, coupon, and badges.
total_results / total_pagesnumberPagination counts when available.
pages_fetchednumberNumber of pages fetched.
time_takennumberAPI 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
    }
  ]
}