Woolworths API

Woolworths Australia products, specials, unit prices, nutrition and stores as JSON.

The API.SH Woolworths API turns public woolworths.com.au pages into structured JSON. Search products, read one product by stockcode with ingredients, allergens, nutrition and reviews, list specials by group, walk the category tree and find stores near an Australian postcode. Product data includes price, was price, unit price, promotions, stock and the health star rating.

Get a free API key Try it in the playground

5 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Search Woolworths products

GET https://api.api.sh/woolworths/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Woolworths API

Grocery price tracking

Watch price, was price, savings and unit price per kg or litre for products you care about over time.

/search /product

Specials and promotion monitoring

List half price, lower shelf price, everyday low price and buy more save more items, narrowed to a department.

/specials

Nutrition, allergen and dietary data

Read ingredients, allergens (contains and may contain), dietary claims, health star rating and nutrition per 100 g and per serve.

/product /search

Catalog and category mapping

Walk the department and aisle tree and page through products by keyword to build a product database.

/categories /search

Store locator and availability

Find stores near a postcode with address, trading hours, distance and facilities, and check product availability for delivery, pickup and express.

/stores /product

Shopping and meal-planning agents

Give an AI agent product search, specials and nutrition so it can build a shopping list that fits a budget or a diet.

/search /specials

Woolworths data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Woolworths API endpoints and prices

Every Woolworths endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Search Woolworths products

/woolworths/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places1

Woolworths product

/woolworths/v1/product

$1 · $2 PAYG

1 credit

More data3

Woolworths category tree /woolworths/v1/categories	$1 · $2 PAYG 1 credit
Woolworths specials /woolworths/v1/specials	$1 · $2 PAYG 1 credit
Woolworths store locator /woolworths/v1/stores	$1 · $2 PAYG 1 credit

Call the Woolworths API

Search Woolworths products: GET https://api.api.sh/woolworths/v1/search

curl "https://api.api.sh/woolworths/v1/search?q=milk" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/woolworths/v1/search",
    params={"q": "milk"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/woolworths/v1/search");
url.searchParams.set("q", "milk");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/woolworths/v1/search", "q", "milk")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Woolworths" and "Search Woolworths products".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Woolworths data

Public data only: no Woolworths login, cookies or account needed
One key and one response shape for Woolworths and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Woolworths API

Woolworths does not advertise a public developer API for its online shop, and search results are mostly community wrappers, GitHub projects, forum threads and paid data services. API.SH needs no key from Woolworths and returns the public product, specials and store data as JSON. It covers Woolworths in Australia.

Rather than keeping your own Woolworths scraper alive or comparing RapidAPI and Apify listings, use API.SH for one key, one JSON shape and a fixed price per call.

Woolworths API questions

What Woolworths data can I get?+

Product search (/woolworths/v1/search), one product with nutrition and reviews (/woolworths/v1/product), specials by group (/woolworths/v1/specials), the category tree (/woolworths/v1/categories) and store lookup by postcode (/woolworths/v1/stores).

How much does the Woolworths API cost?+

Every Woolworths endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /woolworths/v1/categories at 1 credit each.

Is there an official Woolworths API?+

Woolworths does not advertise a public API for product and price data. API.SH is a separate service that reads public woolworths.com.au pages and returns them as JSON.

Do I need a Woolworths account or login?+

No. API.SH reads public Woolworths pages only. No endpoint uses a login, cookies or anyone's account.

Does it cover Woolworths in New Zealand or South Africa?+

No. These routes read Woolworths in Australia (woolworths.com.au), and store lookup takes an Australian postcode.

Can I use it from Python?+

Yes. It is a plain HTTPS API that returns JSON, so any HTTP client or the Python SDK works. Search and specials take limit and page parameters to walk through longer result lists.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /woolworths/v1/search with q set to a product such as milk. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.