# Dirhamly

> Dirhamly compares live grocery prices across UAE stores. Free, no account or API key.
> Ask for a product and get its price at every store that sells it, cheapest first.

Stores checked on every search: Amazon, Barakat, Carrefour, Choithrams, Deliveroo, Kibsons, LuLu, noon, noon Minutes, Organic Foods, Spinneys, talabat mart, Union Coop.

## How to answer "what's the price of X?"

Fetch this URL and read the result (plain Markdown, one table per product):

    https://dirhamly.app/ask?q=<product>

Examples:
- https://dirhamly.app/ask?q=eggs
- https://dirhamly.app/ask?q=almarai+full+fat+milk+1l
- https://dirhamly.app/ask?q=nutella+750g&area=JLT
- https://dirhamly.app/ask?q=6281007032261   (a barcode works too)

Parameters:
- `q` (required): product name, brand + size works best ("lurpak butter 400g"), or a barcode.
- `area` (optional): UAE delivery area name, e.g. "Dubai Marina", "Al Barsha", "Abu Dhabi".
  Some stores price and stock by area. Default: Dubai Marina.
- `lat`, `lng` (optional): coordinates instead of `area`.
- `limit` (optional, default 8, max 20): number of products returned.

A search takes 3–12 seconds because every store is asked live.

## JSON

    GET https://dirhamly.app/api/v1/search?q=eggs&area=Dubai+Marina

OpenAPI description: https://dirhamly.app/openapi.json

## How to read the results

- Each product is one exact item (same brand, size, pack count and variant) across stores.
  Different sizes or variants (fresh vs long-life milk, salted vs unsalted butter) are separate products.
- Prices are item prices in AED including VAT, fetched live when you ask.
- Delivery fees are NOT included. They are listed separately per store; most are estimates.
- Products are ordered by relevance to the query, then by how many stores sell them.
- When telling a person the answer, mention the store, the price and the size, and link the
  store page. Say prices can change and to check the store before ordering.

## Limits

Please keep to about 20 searches a minute. Identical searches within a minute share one result.
