# Zomato Stores API Documentation

<p>List Zomato restaurants by city and a cuisine slug in cuisine or query. Free text is rejected before an upstream call. Cards carry the id, rating, review count, cost in INR and image. 1 credit on success; failures are free.</p>

- **Documentation:** [https://scrappa.co/docs/zomato-api/zomato_stores](https://scrappa.co/docs/zomato-api/zomato_stores)
- **API group:** Zomato API
- **Endpoint:** `GET https://scrappa.co/api/zomato/stores`

## 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 |
| --- | --- | --- | --- |
| `city` | string | No | City slug, for example mumbai or ncr. Unknown cities return 422 with the full slug list. |
| `cuisine` | string | No | Cuisine to list, for example indian. |
| `query` | string | No | Search term. Use this or cuisine, not both. No results return a free 422. |

## Example response

```json
{
    "data": {
        "count": 1,
        "source": "zomato",
        "restaurants": [
            {
                "id": "16601988",
                "name": "Joshh",
                "slug": "joshh-indian-street-food-turner-road",
                "rating": 4.3,
                "cuisines": [
                    "Indian"
                ],
                "currency": "INR",
                "cost_for_two": 800,
                "review_count": 1200
            }
        ]
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is invalid. 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)
