# Asda API

Search Asda Groceries UK, browse categories, list category products, track promotions, and get product detail.

- Platform ID: `asda`
- Capabilities: 5
- Execute endpoint: `POST https://data.upscrape.com/execute`



## Capabilities

### [Categories list](https://docs.upscrape.com/docs/platforms/asda/asda.categories.list)

- Capability ID: `asda.categories.list`
- Cost: 5 credits per request

List the Asda Groceries category taxonomy (category > department > aisle) with product counts, derived from the catalog index facets.
### [Category products list](https://docs.upscrape.com/docs/platforms/asda/asda.category.products.list)

- Capability ID: `asda.category.products.list`
- Cost: 1–10 credits per request

List paginated products from an exact Asda category, department, or aisle returned by the category taxonomy capability.
### [Product detail get](https://docs.upscrape.com/docs/platforms/asda/asda.product.detail.get)

- Capability ID: `asda.product.detail.get`
- Cost: 1 credit per request

Fetch one Asda product by product ID (numeric or SKU-prefixed) or CIN, with country, dietary flags, per-nation prices, and maximum order quantity.
### [Products search](https://docs.upscrape.com/docs/platforms/asda/asda.products.search)

- Capability ID: `asda.products.search`
- Cost: 1–10 credits per request

Search Asda Groceries UK products by keyword, with store-aware stock boosting and normalized price, offer, unit price, rating, GTIN, and taxonomy fields.
### [Promotions list](https://docs.upscrape.com/docs/platforms/asda/asda.promotions.list)

- Capability ID: `asda.promotions.list`
- Cost: 1–10 credits per request

List current Asda rollbacks, price drops, and multi-buy offers, with each multi-buy's ID, name, UTC dates, and quantity deal parsed where the name states one.

## Common uses

- UK grocery price monitoring and promotion tracking
- Assortment and availability analytics across Asda stores
- Retail media and share-of-shelf research on UK grocery search
- Catalog enrichment with Asda GTINs, pack sizes, ratings, and taxonomy

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).