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