Docs / API reference

POST/v1/data/bigbasket/categories

BigBasket Categories

Return BigBasket's category tree as a flat list of slugs you can browse with BigBasket Products.

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.

BigBasket Categories Endpoint

Return BigBasket's category tree as a flat list of slugs you can browse with BigBasket Products.

Getting Started

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

Run BigBasket Categories

Send the smallest useful request and read the structured response.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "parent": "dairy",
  "max_depth": 1
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "count": 10,
  "categories": [
    {
      "category_id": "butter-margarine",
      "name": "Butter & Margarine",
      "slug": "butter-margarine",
      "level": 2,
      "url": "https://www.bigbasket.com/pc/bakery-cakes-dairy/dairy/butter-margarine/",
      "parent_slug": "dairy",
      "path": [
        "Bakery, Cakes & Dairy",
        "Dairy",
        "Butter & Margarine"
      ]
    },
    {
      "category_id": "cheese",
      "name": "Cheese",
      "slug": "cheese",
      "level": 2,
      "url": "https://www.bigbasket.com/pc/bakery-cakes-dairy/dairy/cheese/",
      "parent_slug": "dairy",
      "path": [
        "Bakery, Cakes & Dairy",
        "Dairy",
        "Cheese"
      ]
    }
  ],
  "time_taken": 0.42,
  "credits_used": 1
}

Options

Request Controls

Set device, timeout, and request-specific controls.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "parent": "dairy",
  "max_depth": 1,
  "timeout_ms": 20000
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "count": 10,
  "categories": [
    {
      "category_id": "butter-margarine",
      "name": "Butter & Margarine",
      "slug": "butter-margarine",
      "level": 2,
      "url": "https://www.bigbasket.com/pc/bakery-cakes-dairy/dairy/butter-margarine/",
      "parent_slug": "dairy",
      "path": [
        "Bakery, Cakes & Dairy"
      ]
    }
  ],
  "time_taken": 0.42,
  "credits_used": 1
}

Additional Options

Set endpoint-specific options for this request.

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "parent": "example",
  "max_depth": 3
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "count": 10,
  "categories": [
    {
      "category_id": "butter-margarine",
      "name": "Butter & Margarine",
      "slug": "butter-margarine",
      "level": 2,
      "url": "https://www.bigbasket.com/pc/bakery-cakes-dairy/dairy/butter-margarine/",
      "parent_slug": "dairy",
      "path": [
        "Bakery, Cakes & Dairy"
      ]
    }
  ],
  "time_taken": 0.42,
  "credits_used": 1
}

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
max_depthnumberOptionalLevels to return (1-3). 1 returns top-level categories, or only the parent's direct children.
parentstringOptionalReturn only this category's subtree: a slug such as dairy, or a bigbasket.com/pc/... URL.
timeout_msnumberOptionalProvider deadline in milliseconds (3000-60000).

Response fields

FieldTypeDescription
successbooleanFalse when no category matched.
countnumberCategories returned.
categoriesarrayRows with category_id, name, slug, level (0 = top), url, parent_slug, path, and image_url when BigBasket shows one.
credits_usednumberCredits charged for this request.
errorstringReason when success is false.
time_takennumberAPI response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/bigbasket/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "parent": "dairy",
  "max_depth": 1
}'
Example response
{
  "success": true,
  "source": "bigbasket",
  "count": 10,
  "categories": [
    {
      "category_id": "butter-margarine",
      "name": "Butter & Margarine",
      "slug": "butter-margarine",
      "level": 2,
      "url": "https://www.bigbasket.com/pc/bakery-cakes-dairy/dairy/butter-margarine/",
      "parent_slug": "dairy",
      "path": [
        "Bakery, Cakes & Dairy",
        "Dairy",
        "Butter & Margarine"
      ]
    },
    {
      "category_id": "cheese",
      "name": "Cheese",
      "slug": "cheese",
      "level": 2,
      "url": "https://www.bigbasket.com/pc/bakery-cakes-dairy/dairy/cheese/",
      "parent_slug": "dairy",
      "path": [
        "Bakery, Cakes & Dairy",
        "Dairy",
        "Cheese"
      ]
    }
  ],
  "time_taken": 0.42,
  "credits_used": 1
}