Docs / API reference

POST/v1/data/ajio/products

AJIO Products

Search AJIO products by query or category filters.

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.

AJIO Products Endpoint

Search AJIO products by query or category filters.

Getting Started

Send your API key as a bearer token. Start with the smallest request below.

Run AJIO Products

Send the smallest useful request and read the structured 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",
      "option_code": "460000001_red",
      "title": "Matte Lipstick",
      "brand": "Example Beauty",
      "brand_type": "example-beauty",
      "category": "Beauty",
      "category_id": "8311",
      "subcategory": "Lipstick",
      "subcategory_id": "831101",
      "url": "https://www.ajio.com/example/p/460000001",
      "relative_url": "/example/p/460000001",
      "image_url": "https://assets.ajio.com/example-lipstick.jpg",
      "images": [
        "https://assets.ajio.com/example-lipstick.jpg"
      ],
      "price": 499,
      "price_text": "Rs.499",
      "offer_price": 399,
      "offer_price_text": "Rs. 399",
      "list_price": 799,
      "original_price": 799,
      "original_price_text": "Rs.799",
      "currency": "INR",
      "discount": "38% off",
      "discount_percent": 38,
      "discount_amount": 300,
      "coupon_savings": 100,
      "coupon_status": "Coupon Applicable",
      "coupon_applicable": true,
      "is_best_seller": true,
      "badges": [
        "BESTSELLER"
      ]
    }
  ]
}

Options

Query and Target

Set the search term, identifier, or source URL that defines the request.

curl -X POST "https://api.datablue.dev/v1/data/ajio/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "web scraping tools",
  "maxResults": 10,
  "sortBy": "discount",
  "queries": [
    "milk",
    "bread"
  ],
  "category": "example",
  "subcategory": "example"
}'
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",
      "option_code": "460000001_red",
      "title": "Matte Lipstick",
      "brand": "Example Beauty",
      "brand_type": "example-beauty",
      "category": "Beauty",
      "category_id": "8311",
      "subcategory": "Lipstick"
    }
  ]
}

Results and Pagination

Control how many records or pages are returned.

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",
  "num_results": 20,
  "page": 1
}'
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",
      "option_code": "460000001_red",
      "title": "Matte Lipstick",
      "brand": "Example Beauty",
      "brand_type": "example-beauty",
      "category": "Beauty",
      "category_id": "8311",
      "subcategory": "Lipstick"
    }
  ]
}

Filters and Sorting

Narrow or order the returned records.

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",
  "min_price": 10,
  "max_price": 10,
  "sort_by": "example"
}'
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",
      "option_code": "460000001_red",
      "title": "Matte Lipstick",
      "brand": "Example Beauty",
      "brand_type": "example-beauty",
      "category": "Beauty",
      "category_id": "8311",
      "subcategory": "Lipstick"
    }
  ]
}

Request Controls

Set device, timeout, and request-specific controls.

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",
  "timeout_ms": 20000
}'
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",
      "option_code": "460000001_red",
      "title": "Matte Lipstick",
      "brand": "Example Beauty",
      "brand_type": "example-beauty",
      "category": "Beauty",
      "category_id": "8311",
      "subcategory": "Lipstick"
    }
  ]
}

Response

Read success first, then consume the endpoint-specific records and pagination fields shown below.

Error Handling

Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.

Parameters

NameTypeRequirementDescription
query / searchstringOptionalProduct 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 / minPrice / priceMinnumberOptionalMinimum payable price in INR.
max_price / maxPrice / priceMaxnumberOptionalMaximum payable price in INR.
num_results / maxResults / maxProductsPerSearchnumberOptionalMaximum products to return (1-200).
pagenumberOptionalStarting page (1-20).
sort_by / sortBystringOptionalSort order: relevance, discount, price_low, price_high, or newest. Common price-asc/price-desc aliases are accepted.
timeout_msnumberOptionalProvider timeout in milliseconds (3000-60000).

Response fields

FieldTypeDescription
successbooleanWhether the AJIO request completed successfully.
products[].identityobjectproduct_id, sku, option_code, title, brand, and brand_type.
products[].taxonomyobjectCategory, subcategory, segment, vertical, and brick labels with their source IDs.
products[].pricingobjectRegular price, coupon offer price, MRP/list price, formatted values, discount amount/percent, coupon savings, and currency.
products[].mediaobjectPrimary image, all source images, model images, outfit image, absolute URL, and relative URL.
products[].signalsobjectCoupon status, promotion/gift flags, bestseller/new flags, wishlist evidence, badges, and structured tags.
products[].rating / rating_count / review_countnumberIncluded only when AJIO supplies these values; missing source ratings are not converted to zero.
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",
      "option_code": "460000001_red",
      "title": "Matte Lipstick",
      "brand": "Example Beauty",
      "brand_type": "example-beauty",
      "category": "Beauty",
      "category_id": "8311",
      "subcategory": "Lipstick",
      "subcategory_id": "831101",
      "url": "https://www.ajio.com/example/p/460000001",
      "relative_url": "/example/p/460000001",
      "image_url": "https://assets.ajio.com/example-lipstick.jpg",
      "images": [
        "https://assets.ajio.com/example-lipstick.jpg"
      ],
      "price": 499,
      "price_text": "Rs.499",
      "offer_price": 399,
      "offer_price_text": "Rs. 399",
      "list_price": 799,
      "original_price": 799,
      "original_price_text": "Rs.799",
      "currency": "INR",
      "discount": "38% off",
      "discount_percent": 38,
      "discount_amount": 300,
      "coupon_savings": 100,
      "coupon_status": "Coupon Applicable",
      "coupon_applicable": true,
      "is_best_seller": true,
      "badges": [
        "BESTSELLER"
      ]
    }
  ]
}