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.

Code example

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"
}'

System responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

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
    }
  ]
}