API Documentation

Authentication

All /v1/* endpoints require an API key passed via the X-API-Key header.

curl -H "X-API-Key: your-api-key" \
  "https://api.quickcommerceapi.com/v1/search?q=milk&lat=12.9021&lon=77.6639&platform=BlinkIt"

# Or pass API key as a query parameter:
curl "https://api.quickcommerceapi.com/v1/search?q=milk&lat=12.9021&lon=77.6639&platform=BlinkIt&api_key=your-api-key"

Get your API key from the Dashboard after signing up. Each successful API call costs 1 credit. API key can be passed via X-API-Key header or api_key query parameter.

Search Products

Search for products on a specific quick commerce platform by location.

Query Parameters

GET /v1/search?q=pizza&lat=12.9021&lon=77.6639&platform=BlinkIt

{
  "status": "success",
  "request_id": "a1b2c3d4-...",
  "credits_remaining": 49,
  "data": {
    "query": "pizza",
    "platform": "BlinkIt",
    "lat": 12.9021,
    "lon": 77.6639,
    "total_results": 30,
    "products": [
      {
        "id": "501346",
        "name": "Margherita Pizza",
        "brand": "Amul",
        "available": true,
        "images": ["https://cdn.grofers.com/..."],
        "mrp": 120,
        "offer_price": 120,
        "quantity": "210 g",
        "deeplink": "https://blinkit.com/prn/x/prid/501346",
        "rating": 4.06,
        "rating_count": 1891,
        "inventory": 6,
        "platform": {
          "name": "BlinkIt",
          "sla": "8 mins",
          "open": true,
          "icon": "https://d2chhaxkq6tvay.cloudfront.net/..."
        }
      }
    ]
  }
}

Item Details

Get real-time price, stock, and availability for a specific item on a platform. Use the id from search results.

Query Parameters

GET /v1/item?item_id=362674&lat=12.9021&lon=77.6639&platform=BlinkIt

{
  "status": "success",
  "request_id": "a1b2c3d4-...",
  "credits_remaining": 48,
  "data": {
    "item_id": "362674",
    "name": "Tender Coconut (Thengina Kayi)",
    "brand": null,
    "quantity": "1 pc",
    "available": true,
    "price": 65,
    "mrp": 82,
    "inventory": 20,
    "deeplink": "https://blinkit.com/prn/x/prid/362674",
    "rating": null,
    "rating_count": null,
    "platform": "BlinkIt",
    "store_id": "45342",
    "fetched_at": "16-03-2026 06:52:12 AM"
  }
}

Delivery ETA

Get estimated delivery time and store availability for a platform at a given location. Useful for checking if a platform is operational and how fast it can deliver.

Query Parameters

GET /v1/eta?lat=12.9021&lon=77.6639&platform=BlinkIt

{
  "status": "success",
  "request_id": "a1b2c3d4-...",
  "credits_remaining": 47,
  "data": {
    "platform": "BlinkIt",
    "eta": "14 mins",
    "open": true,
    "store_id": "45342",
    "store_ids": ["36475", "38212", "42814", "45342"],
    "icon": "https://d2chhaxkq6tvay.cloudfront.net/platforms/blinkit.webp",
    "url": "https://blinkit.com",
    "lat": 12.9021,
    "lon": 77.6639
  }
}

Check Credits

Check your available credits, usage summary, and per-recharge breakdown. This endpoint is free — it does not consume any credits.

GET /v1/credits

{
  "summary": {
    "total_available": 2450,
    "total_used": 50,
    "active_packs": 2
  },
  "active": [
    {
      "id": "a1b2c3d4-...",
      "pack_name": "starter",
      "credits_total": 2500,
      "credits_remaining": 2450,
      "credits_used": 50,
      "amount_paid": 500.0,
      "is_trial": false,
      "status": "active",
      "purchased_at": "2026-03-16T05:14:03Z",
      "expires_at": "2026-04-15T05:14:03Z"
    }
  ],
  "inactive": [
    {
      "id": "e5f6g7h8-...",
      "pack_name": "trial",
      "credits_total": 50,
      "credits_remaining": 0,
      "credits_used": 50,
      "amount_paid": 0.0,
      "is_trial": true,
      "status": "exhausted",
      "purchased_at": "2026-03-10T10:00:00Z",
      "expires_at": "2026-04-09T10:00:00Z"
    }
  ]
}

Response Fields

Supported Platforms

Returns the list of all supported quick commerce platform names. This endpoint is free — no authentication or credits required.

GET /v1/supported-platforms

{
  "platforms": [
    "BlinkIt",
    "Zepto",
    "Swiggy",
    "BigBasket",
    "DMart",
    "JioMart",
    "Minutes"
  ],
  "count": 7
}

Error Codes

Response Headers

Every API response includes these headers: