Morrisons APImorrisons.com ↗
Access Morrisons grocery products, prices, reviews, promotions, and category data via 8 structured endpoints. Search, browse, and retrieve nutritional and rating data.
What is the Morrisons API?
The Morrisons API covers 8 endpoints for querying the Morrisons online supermarket catalog, including full-text product search, category browsing, individual product detail, customer reviews, and active promotions. The get_product_detail endpoint alone returns nutritional fields, storage instructions, breadcrumbs, promotion objects, and lists of related and similar product IDs — giving a complete data profile for any single grocery item.
curl -X GET 'https://api.parse.bot/scraper/4a18317c-6c6e-41eb-a4aa-70ff891f9db2/search_products?limit=10&query=milk' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace morrisons-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.morrisons_grocery_api import Morrisons, Category, ReviewSort, ProductNotFound
morrisons = Morrisons()
# Search for products — limit caps total items fetched
for group in morrisons.products.search(query="milk", limit=3):
print(group.type)
for product in group.decorated_products:
print(product.name, product.price.amount, product.price.currency)
# Autocomplete suggestions for partial queries
for suggestion in morrisons.products.suggestions(query="bre", limit=5):
print(suggestion)
# Get a specific product by its retailer ID
milk = morrisons.products.get(retailer_product_id="113240422")
print(milk.name, milk.brand, milk.available)
# Fetch reviews sorted by highest rated
review_page = milk.reviews(sort=ReviewSort.HIGHEST_RATED)
print(review_page.review_count, review_page.rating_histogram)
for review in review_page.reviews:
print(review.headline, review.rating, review.is_verified_buyer)
# Browse current promotions
for group in morrisons.products.promotions(limit=2):
for product in group.decorated_products:
print(product.name, product.price.amount)
# Browse category tree and drill into a category's products
for cat in morrisons.categories.list(limit=3):
print(cat.name, cat.retailer_category_id, cat.product_count)
fruit_veg = morrisons.category(retailer_category_id="176738")
for group in fruit_veg.products(limit=2):
for product in group.decorated_products:
print(product.name, product.brand)
# Typed error handling
try:
morrisons.products.get(retailer_product_id="000000000")
except ProductNotFound as exc:
print(f"Product not found: {exc.retailer_product_id}")
print("exercised: search / suggestions / get / reviews / promotions / categories.list / category.products")
Full-text search over the Morrisons product catalog. Returns paginated product groups containing decorated product objects with names, prices, images, ratings, and promotions. Each product group has a type (featured, personalized) and contains a decoratedProducts array.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return per page. |
| queryrequired | string | Search keyword (e.g. 'milk', 'bread', 'chicken') |
{
"type": "object",
"fields": {
"metadata": "object with nextPageToken for pagination",
"productGroups": "array of product group objects, each containing a decoratedProducts array with product details",
"additionalPageInfo": "object with categories, filters, sortOptions, and query info"
},
"sample": {
"data": {
"metadata": {
"nextPageToken": "e8caaf30-c8ce-4fe5-9311-dbf960eb9e29"
},
"productGroups": [
{
"type": "personalized",
"decoratedProducts": [
{
"name": "Morrisons British Semi Skimmed Milk 4 Pint",
"brand": "Morrisons",
"price": {
"amount": "1.65",
"currency": "GBP"
},
"available": true,
"productId": "721a6e29-4bab-43e1-a241-a34296dd606e",
"ratingSummary": {
"count": 21,
"overallRating": "3.2"
},
"retailerProductId": "113240422"
}
]
}
],
"additionalPageInfo": {
"sortOptions": [
{
"selected": true,
"sortOptionId": "favorite"
}
]
}
},
"status": "success"
}
}About the Morrisons API
Product Search and Discovery
The search_products endpoint accepts a query string and an optional limit parameter, returning paginated productGroups arrays. Each group carries a type label (such as featured or personalized) and a decoratedProducts array containing product names, prices, images, rating summaries, and any active promotions. A nextPageToken in the metadata object handles pagination. The additionalPageInfo field adds filter options, sort options, and category facets for the query. For typeahead interfaces, get_search_suggestions takes a partial string and returns a suggestions array of completed terms.
Category Browsing
get_category_list returns the full Morrisons category tree as a nested categories array with up to 4 levels of childCategories. Each node includes a name, categoryId, retailerCategoryId, and productCount. Pass a retailerCategoryId to get_products_by_category to get paginated product listings for that node, along with breadcrumb data and sort/filter options in additionalPageInfo.
Product Detail and Reviews
get_product_detail takes a numeric retailer_product_id and returns a product object with name, brand, price, images, ratingSummary, categoryPath, and a promotions array. The bopData object adds a detailedDescription and structured fields covering brand, storage and usage, and return address. bopPromotions lists expanded promotion objects. For social proof data, get_product_reviews accepts a UUID product_id and returns an array of reviews — each with a headline, rating, nickname, createdDate, comments text, and isVerifiedBuyer flag — plus a ratingHistogram of five integers covering 1-star through 5-star counts.
Promotions and Similar Products
get_promotions returns currently active site-wide offers as productGroups containing decorated products on promotion, with no required inputs. get_similar_products accepts a retailer_product_id and returns an items array of UUID productId strings that can feed directly into get_product_reviews or further detail lookups.
The Morrisons API is a managed, monitored endpoint for morrisons.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when morrisons.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official morrisons.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a grocery price tracker that monitors Morrisons product prices and flags promotion changes from
get_promotions. - Aggregate nutritional data across product categories using the
fieldsobject returned byget_product_detail. - Power a recipe cost estimator by searching ingredients via
search_productsand extracting per-unit prices. - Construct a review sentiment dashboard using
reviews,ratingHistogram, andisVerifiedBuyerfromget_product_reviews. - Generate a competitive category map by traversing the four-level hierarchy from
get_category_list. - Build a typeahead search widget for a Morrisons-focused shopping app using
get_search_suggestions. - Identify product bundles or substitution options by walking the
similarProductsandrelatedProductsarrays fromget_product_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Morrisons have an official public developer API?+
What is the difference between `relatedProducts` and `similarProducts` in `get_product_detail`?+
get_product_detail returns both relatedProducts and similarProducts as separate arrays of product IDs. relatedProducts typically reflects editorially or contextually linked items, while similarProducts reflects substitutable alternatives. Both return numeric and UUID identifiers usable in further endpoint calls.Does the API return Morrisons More loyalty card pricing or member-only promotions?+
promotions array on product objects and in bopPromotions. Member-exclusive pricing tied to individual loyalty accounts is not currently exposed. You can fork this API on Parse and revise it to target account-specific pricing endpoints if that data becomes accessible.How does pagination work across endpoints that return product listings?+
search_products, get_products_by_category, and get_promotions all return a metadata object containing a nextPageToken string. Pass that token in your next request to retrieve the following page of results. get_product_reviews uses a nextPage field inside its own metadata object for the same purpose.