Harris Farm Markets
Harris Farm Markets grocery prices at every store, specials with the savings, unit prices, stores with trading hours, recipes and the full catalogue.
/harrisfarm/v1/search2 creditsKeyword search over the Harris Farm catalogue, with the real price at every store, the site's filters (category, dietary & lifestyle, allergen-free, store, on special) and their counts, sort by relevance or price, cursor paging. `total` and paging stop at 1000 (source limit).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Words to search for. |
| store | optional | — | A Harris Farm store: its number (e.g. 57) or name (e.g. 'Bondi Beach', 'West End'). Prices, specials and ranging differ by store. When set, rows are limited to products the store ranges (as the site does) and each row gets `at_store`. See action `stores` for every number. |
| postcode | optional | — | An Australian postcode; the store that serves it (the site's own postcode lookup) is used as `store`. Harris Farm serves parts of NSW, QLD and the ACT; other postcodes answer INVALID_PARAM. |
| category | optional | — | The site's Category filter; several comma-separated OR together. Values: Bakery, Cheese, Cleaning, Confectionary, Deli, Drinks, Flower, Flowers, Fridge, Frozen, Fruit, Grocery, Health Foods, Liquor, Meat, Pantry, Pasta, Personal Care & Hygiene, Pet, Plants, Ready to Cook, Ready To Cook, Seafood, Value Box, Value Boxes, Vegetables, Vitamins. |
| dietary | optional | — | The site's 'Dietary & Lifestyle' filter (comma-separated OR). Values: Australian Made, Cholesterol Free, Dairy Free, Fibre, Free Range, Gluten Free, GMO Free, Halal, Kosher, Organic, Paleo, Sugar Free, Vegan, Vegetarian, Wholegrain. |
| allergen_free | optional | — | The site's 'Allergens' filter (free-from claims, comma-separated OR). Values: Allergen Free, Antibiotic Free, Artificial Preservatives Free, BPA Free, Dairy Free, Egg Free, Free Range, Gluten Free, Lactose Free, Nitrite Free, No Artificial colours, No Artificial flavours, No Preservatives, Nut Free, Organic, Peanut Free, Soy Free. |
| on_special = false | optional | — | Only products on special — at `store` when a store is given, otherwise on special at any store. |
| sort = relevance | optional | relevance · price-ascending · price-descending | relevance (default), price-ascending, price-descending — the site's search sorts. Price order follows the catalogue base price (the site sorts the same way). |
| limit = 50 | optional | 1–100 | Rows per call. 50 = the site's own search page size. Max 100. |
| cursor | optional | — | `next_cursor` from the previous call, for the next page. |
/harrisfarm/v1/collection_products2 creditsProducts of one collection (category page, e.g. fruit, butcher-specials, organic-fruit) with store prices, the site's filters and counts, every sort the site offers, cursor paging.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| collection | required | — | Collection handle (from /collections/<handle>) or URL. See `categories` and `collections`. |
| store | optional | — | A Harris Farm store: its number (e.g. 57) or name (e.g. 'Bondi Beach', 'West End'). Prices, specials and ranging differ by store. When set, rows are limited to products the store ranges (as the site does) and each row gets `at_store`. See action `stores` for every number. |
| postcode | optional | — | An Australian postcode; the store that serves it (the site's own postcode lookup) is used as `store`. Harris Farm serves parts of NSW, QLD and the ACT; other postcodes answer INVALID_PARAM. |
| category | optional | — | The site's Category filter; several comma-separated OR together. Values: Bakery, Cheese, Cleaning, Confectionary, Deli, Drinks, Flower, Flowers, Fridge, Frozen, Fruit, Grocery, Health Foods, Liquor, Meat, Pantry, Pasta, Personal Care & Hygiene, Pet, Plants, Ready to Cook, Ready To Cook, Seafood, Value Box, Value Boxes, Vegetables, Vitamins. |
| dietary | optional | — | The site's 'Dietary & Lifestyle' filter (comma-separated OR). Values: Australian Made, Cholesterol Free, Dairy Free, Fibre, Free Range, Gluten Free, GMO Free, Halal, Kosher, Organic, Paleo, Sugar Free, Vegan, Vegetarian, Wholegrain. |
| allergen_free | optional | — | The site's 'Allergens' filter (free-from claims, comma-separated OR). Values: Allergen Free, Antibiotic Free, Artificial Preservatives Free, BPA Free, Dairy Free, Egg Free, Free Range, Gluten Free, Lactose Free, Nitrite Free, No Artificial colours, No Artificial flavours, No Preservatives, Nut Free, Organic, Peanut Free, Soy Free. |
| on_special = false | optional | — | Only products on special — at `store` when a store is given, otherwise on special at any store. |
| sort = manual | optional | manual · best-selling · title-ascending · title-descending · price-ascending · price-descending · created-ascending · created-descending | The site's collection sorts: manual (featured, default), best-selling, title-ascending, title-descending, price-ascending, price-descending, created-ascending, created-descending. |
| limit = 40 | optional | 1–100 | Rows per call. 40 = the site's own collection page size. Max 100. |
| cursor | optional | — | `next_cursor` from the previous call, for the next page. |
/harrisfarm/v1/specials2 creditsWhat is on special right now — the site's own Specials list — at one store (number, name or postcode) or at any store, optionally by department (category) or diet, with each store's price and the 'Save $x' text, every collection sort, cursor paging and the store's count.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| store | optional | — | A Harris Farm store: its number (e.g. 57) or name (e.g. 'Bondi Beach', 'West End'). Prices, specials and ranging differ by store. When set, rows are limited to products the store ranges (as the site does) and each row gets `at_store`. See action `stores` for every number. |
| postcode | optional | — | An Australian postcode; the store that serves it (the site's own postcode lookup) is used as `store`. Harris Farm serves parts of NSW, QLD and the ACT; other postcodes answer INVALID_PARAM. |
| category | optional | — | The site's Category filter; several comma-separated OR together. Values: Bakery, Cheese, Cleaning, Confectionary, Deli, Drinks, Flower, Flowers, Fridge, Frozen, Fruit, Grocery, Health Foods, Liquor, Meat, Pantry, Pasta, Personal Care & Hygiene, Pet, Plants, Ready to Cook, Ready To Cook, Seafood, Value Box, Value Boxes, Vegetables, Vitamins. |
| dietary | optional | — | The site's 'Dietary & Lifestyle' filter (comma-separated OR). Values: Australian Made, Cholesterol Free, Dairy Free, Fibre, Free Range, Gluten Free, GMO Free, Halal, Kosher, Organic, Paleo, Sugar Free, Vegan, Vegetarian, Wholegrain. |
| allergen_free | optional | — | The site's 'Allergens' filter (free-from claims, comma-separated OR). Values: Allergen Free, Antibiotic Free, Artificial Preservatives Free, BPA Free, Dairy Free, Egg Free, Free Range, Gluten Free, Lactose Free, Nitrite Free, No Artificial colours, No Artificial flavours, No Preservatives, Nut Free, Organic, Peanut Free, Soy Free. |
| sort = manual | optional | manual · best-selling · title-ascending · title-descending · price-ascending · price-descending · created-ascending · created-descending | The site's collection sorts: manual (featured, default), best-selling, title-ascending, title-descending, price-ascending, price-descending, created-ascending, created-descending. |
| limit = 40 | optional | 1–100 | Rows per call (40 = the site's collection page size). Max 100. |
| cursor | optional | — | `next_cursor` from the previous call, for the next page. |
/harrisfarm/v1/product2 creditsFull product: title, description, vendor, images, variants (SKU, weight, stock flags), diet and allergen claims, collections, and a row per store with the price, unit price as printed (e.g. $2.43 / 100g), special and savings text, ranging and country of origin; plus the price the site shows with no store chosen.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| handle | optional | — | The product handle from its URL (/products/<handle>), or the full product URL. |
| product_id | optional | — | The numeric Shopify product id (`product_id` in every row). |
| store | optional | — | A Harris Farm store: its number (e.g. 57) or name (e.g. 'Bondi Beach', 'West End'). Prices, specials and ranging differ by store. When set, rows are limited to products the store ranges (as the site does) and each row gets `at_store`. See action `stores` for every number. |
| postcode | optional | — | An Australian postcode; the store that serves it (the site's own postcode lookup) is used as `store`. Harris Farm serves parts of NSW, QLD and the ACT; other postcodes answer INVALID_PARAM. |
/harrisfarm/v1/product_recommendations1 creditProducts the site pairs with a product: related and/or complementary, with store prices.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| handle | optional | — | The product handle from its URL (/products/<handle>), or the full product URL. |
| product_id | optional | — | The numeric Shopify product id (`product_id` in every row). |
| intent = both | optional | related · complementary · both | related, complementary or both (default). |
| store | optional | — | A Harris Farm store: its number (e.g. 57) or name (e.g. 'Bondi Beach', 'West End'). Prices, specials and ranging differ by store. When set, rows are limited to products the store ranges (as the site does) and each row gets `at_store`. See action `stores` for every number. |
| postcode | optional | — | An Australian postcode; the store that serves it (the site's own postcode lookup) is used as `store`. Harris Farm serves parts of NSW, QLD and the ACT; other postcodes answer INVALID_PARAM. |
/harrisfarm/v1/autocomplete2 creditsTypeahead as on the site: products (with store prices), collections, recipes/pages, articles and suggested searches for a partial query.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Partial text. |
| limit = 10 | optional | 1–10 | Results per type (source maximum 10). |
| store | optional | — | A Harris Farm store: its number (e.g. 57) or name (e.g. 'Bondi Beach', 'West End'). Prices, specials and ranging differ by store. When set, rows are limited to products the store ranges (as the site does) and each row gets `at_store`. See action `stores` for every number. |
| postcode | optional | — | An Australian postcode; the store that serves it (the site's own postcode lookup) is used as `store`. Harris Farm serves parts of NSW, QLD and the ACT; other postcodes answer INVALID_PARAM. |
/harrisfarm/v1/categories1 creditThe site's category tree (the 'Browse products' menu: department → group → collection) and the Category filter values with product counts.
Try in playground →/harrisfarm/v1/collection2 creditsOne collection's details: title, description, image, product count, dates and every filter value with its count.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| collection | required | — | Collection handle or URL. |
/harrisfarm/v1/collections2 creditsAll collections (about 4 900) with product counts, page by page — or collections whose title matches `query`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Words in the collection title (switches to title search; no counts). |
| page = 1 | optional | 1–1000 | Page number for the full list. |
| limit = 50 | optional | 1–250 | Collections per page (max 250). |
| cursor | optional | — | `next_cursor` from the previous call, for the next page. |
/harrisfarm/v1/stores1 creditEvery Harris Farm store and butcher: store number, address, state, postcode, coordinates, features, click & collect, and the store page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| state | optional | NSW · QLD · ACT | Only stores in this state. |
/harrisfarm/v1/store1 creditOne store: trading hours for every day, address, phone, email, parking, coordinates, features and its weekly specials sheet (the products on it).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| store | required | — | Store number, name or store page handle (e.g. 57, 'Bondi Beach', 'mosman-butcher'). |
/harrisfarm/v1/store_by_postcode1 creditWhich Harris Farm store serves a postcode (the site's own lookup): store, delivery zone, express availability and the suburbs covered.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| postcode | required | — | 4-digit Australian postcode. |
/harrisfarm/v1/recipes1 creditThe site's recipes (about 400), newest first, 40 per page as on the site, optionally matching words.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Words in the recipe title. |
| page = 1 | optional | 1–100 | Page number. |
| limit = 40 | optional | 1–100 | Recipes per page (40 = the site's own 'load more' step). |
/harrisfarm/v1/recipe1 creditOne recipe: intro, prep/cook time, serves, ingredient groups, method steps, notes, and the products it uses with store prices.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| recipe | required | — | Recipe handle (from `recipes`) or URL. |
| store | optional | — | A Harris Farm store: its number (e.g. 57) or name (e.g. 'Bondi Beach', 'West End'). Prices, specials and ranging differ by store. When set, rows are limited to products the store ranges (as the site does) and each row gets `at_store`. See action `stores` for every number. |
| postcode | optional | — | An Australian postcode; the store that serves it (the site's own postcode lookup) is used as `store`. Harris Farm serves parts of NSW, QLD and the ACT; other postcodes answer INVALID_PARAM. |
/harrisfarm/v1/blogs1 creditEvery blog on the site (Dave's Market Update, News, Guides, Nutrition Facts, …).
Try in playground →/harrisfarm/v1/articles1 creditArticles of one blog, newest first, page by page as on the site (title, date, image, link).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| blog | required | — | Blog handle from `blogs` (e.g. news, daves-market-update, all). |
| page = 1 | optional | 1–500 | Page number. |
/harrisfarm/v1/article1 creditOne article: title, date, author, tags, full text and HTML, images and the products it links to.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | optional | — | Article URL (/blogs/<blog>/<handle>). |
| blog | optional | — | Blog handle (with `handle`). |
| handle | optional | — | Article handle (with `blog`). |
/harrisfarm/v1/catalogue3 creditsThe whole catalogue (about 11 900 products, 9 900 listed on the website), up to 250 per call with store prices, optionally by product type, tag, title words or date.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_type | optional | — | Shopify product type, e.g. Z-Bakery, S10M-Fruit, Frdg5-Meat. |
| tag | optional | — | Product tag, e.g. Bananas. |
| title | optional | — | Words in the title (prefix match on the last word). |
| updated_since | optional | — | Only products updated on/after this date (YYYY-MM-DD). |
| created_since | optional | — | Only products created on/after this date (YYYY-MM-DD). |
| sort = id | optional | id · title-ascending · title-descending · price-ascending · price-descending · best-selling · created-ascending · created-descending · updated-ascending · updated-descending | Order of the walk. |
| limit = 100 | optional | 1–250 | Products per call (max 250). |
| cursor | optional | — | `next_cursor` from the previous call, for the next page. |
/harrisfarm/v1/sitemap3 creditsThe site's own sitemaps: every product, collection, article, blog or page link with last update (and image for products), one sitemap file per call.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| kind = products | optional | products · collections · articles · blogs · pages | Which sitemap. |
| page = 1 | optional | 1–50 | Sitemap file number for that kind (products has 10). |
curl -X POST https://api.reefapi.com/harrisfarm/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"mango"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.