# BigBasket Search API Documentation

<p><strong>BigBasket Search API</strong> returns grocery products for a category path and delivery pincode. Each item has a name, brand, pack, INR price, MRP, discount, availability, full-size image and the id the product route accepts.</p><p>This is category-and-location search, not free-text keyword search. Use a path id from the Categories API. Pagination uses a real page number. Costs 1 credit per successful page with results.</p>

- **Documentation:** [https://scrappa.co/docs/bigbasket-api/bigbasket_search](https://scrappa.co/docs/bigbasket-api/bigbasket_search)
- **API group:** BigBasket API
- **Endpoint:** `GET https://scrappa.co/api/bigbasket/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `path` | string | Yes | Category path id from the Categories API |
| `pincode` | string | Yes | Supported six-digit Indian delivery pincode |
| `page` | integer | No | Page number from 1 |

## Example response

```json
{
    "data": {
        "page": 1,
        "path": "fruits-vegetables",
        "count": 1,
        "items": [
            {
                "id": "/pd/71794/banana-robusta",
                "name": "Banana Robusta",
                "pack": "1 kg",
                "brand": "BigBasket",
                "image": "https://example.invalid/banana.png",
                "price": 45,
                "currency": "INR",
                "discount": 10,
                "position": 1,
                "availability": "in_stock",
                "regular_price": 55
            }
        ],
        "pincode": "110001",
        "page_count": 33,
        "has_next_page": true
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Unsupported pincode | The pincode is not supported. Not billed. |
| 503 | Upstream unavailable | BigBasket could not be reached. Not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
