# Target AU Scraper – Products, Prices & Reviews (`abotapi/target-au-scraper`) Actor

Scrape products and customer reviews from Target.com.au. Search by keyword or use product/category URLs with sorting and filters. Returns name, brand, price, OnePass price, ratings, review text and stats, colours, sizes, images, category, stock, and variations.

- **URL**: https://apify.com/abotapi/target-au-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 0 monthly users, 97.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 product results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Target Australia Scraper

Extract products, **specials** and customer reviews from **target.com.au** —
Australia's Target department store. Search by keyword or paste product, category,
and search URLs. Every product comes back as one flat record with pricing (current
**and** was/original price plus the savings), images, category, stock, variations,
and (optionally) full ratings and reviews.

### What you get

- **Product identity** — name, canonical title, brand, product id, product URL,
  category path and breadcrumbs
- **Pricing & specials** — current price, was/original price, savings amount and
  percent, on-special and clearance flags, promo label, OnePass price, currency
- **Details** — description, feature list, care instructions
- **Merchandising** — colour, size/colour variants (with per-variant price and
  was-price), variant count, images, stock, availability, exclusivity flags
- **Ratings & reviews** — average rating and review count (from each product's
  own summary), plus, when detail enrichment is on, the full rating distribution,
  recommended count, and each review's author, rating, title, body, date,
  verified-purchase flag, helpfulness, and sub-ratings

### Specials & offers

Pick a **Specials / offers** collection in search mode to keep only promotional
products:

- **On sale** — reduced lines that carry a strike-through was-price
- **Clearance** — run-out lines
- **New arrivals** — the latest range

Combine it with search terms to scope a promo to a keyword (e.g. `shirt` +
On sale), or leave the terms empty to walk the whole promo collection. In URL
mode you can paste a specials-listing link and it is walked the same way. For
every discounted product the record carries the **was/original price**, the
**savings amount and percent**, and an `isOnSpecial` flag alongside the current
price. Products that are not reduced return these fields as `null` / `false` — a
discount is never fabricated.

### Modes

**Search mode** — provide one or more keywords and, optionally, a specials
collection, a brand, colour, price range, and a sort order (relevance, latest,
rating, price, brand).

**URL mode** — paste any mix of:

- product URLs — `https://www.target.com.au/p/<slug>/<code>`
- category URLs — `https://www.target.com.au/c/<path>/<id>`
- search URLs — `https://www.target.com.au/search?text=<keywords>`

Both modes walk pages forward until the result set or your `Max products` cap is
reached.

### Example input

```json
{
  "mode": "search",
  "searchTerms": ["linen shirt"],
  "specialsCategory": "on-sale",
  "sortBy": "price-asc",
  "maxItems": 50,
  "fetchReviews": true,
  "maxReviews": 20
}
```

### Example output

> The record below is illustrative sample data.

```json
{
  "kind": "product",
  "id": "W1234567890",
  "name": "Sample Linen Long Sleeve Shirt",
  "title": "Sample Brand Sample Linen Long Sleeve Shirt",
  "url": "https://www.target.com.au/p/sample-linen-long-sleeve-shirt/12345678",
  "brand": "Sample Brand",
  "price": 45.0,
  "wasPrice": 60.0,
  "savingsAmount": 15.0,
  "savingsPercent": 25,
  "isOnSpecial": true,
  "promoLabel": null,
  "onePassPrice": null,
  "currency": "AUD",
  "onSale": true,
  "clearance": false,
  "description": "A lightweight, breathable everyday shirt.",
  "features": ["Regular fit", "Button-through front", "Curved hemline"],
  "careInstructions": ["Warm delicate machine wash", "Do not bleach"],
  "category": "Clothing & Accessories > Clothing > Shirts & Tops",
  "breadcrumbs": ["Clothing & Accessories", "Clothing", "Shirts & Tops"],
  "topLevelCategory": "Women",
  "availability": "NORMAL",
  "colour": "White",
  "inStock": true,
  "onlineDate": "2026-05-24",
  "image": "https://assets.target.com.au/transform/00000000-0000-0000-0000-000000000000/sample_1",
  "images": [
    "https://assets.target.com.au/transform/00000000-0000-0000-0000-000000000000/sample_1",
    "https://assets.target.com.au/transform/11111111-1111-1111-1111-111111111111/sample_2"
  ],
  "variantCount": 1,
  "variations": [
    { "colour": "White", "price": 45.0, "wasPrice": 60.0, "savingsAmount": 15.0, "savingsPercent": 25, "inStock": true }
  ],
  "averageRating": 4.8,
  "reviewCount": 18,
  "ratingDistribution": { "5": 15, "4": 3 },
  "recommendedCount": 17,
  "reviewsCollected": 2,
  "reviews": [
    {
      "id": "100000001",
      "rating": 5,
      "title": "Great everyday shirt",
      "body": "Comfortable and true to size.",
      "author": "Sample Reviewer",
      "location": "Victoria",
      "date": "2026-03-19T12:18:09.000+00:00",
      "verifiedPurchase": true,
      "isRecommended": true,
      "helpfulCount": 3,
      "subRatings": { "Quality": 5, "Value For Money": 5 }
    }
  ]
}
```

### Ratings & reviews

Turn on **Fetch ratings and reviews** to attach ratings and reviews to each
product. Products with no reviews leave the rating and review fields absent (they
are never faked). Review photos and videos are intentionally not included.

### Filters & sorting

- **Sort:** relevance, latest, rating, price (low to high / high to low), brand
- **Filters:** specials collection (on sale, clearance, new arrivals), brand,
  colour (exact facet values), and a price range

### Connection

Runs on Apify Proxy — the default automatic pool is enough. Target Australia
serves its home market, so residential Australian exits are used automatically as
a reliability fallback if needed.

### Export to your apps (optional)

Pipe results straight into Notion, Linear, Airtable, or Apify via Model Context
Protocol (MCP) connectors. Authorize a connector under **Settings → API &
Integrations**, then select it in the input. This is a side-channel; it never
changes the dataset.

### Notes

- Prices are in AUD.
- One dataset row per product; reviews are nested under each product.
- Use `Max products` to bound a run (default 20). Set `Max pages per search` to `0` to walk the **whole catalogue** — the run still stops naturally once the storefront's own result total is reached or a page repeats, so there is no artificial page cap.
- **Resume a large run:** pass a prior run's ID (or dataset ID) as `resumeFromRunId` and the scraper seeds its de-duplication set from that run, appending only items it hasn't seen — handy for topping up a full-catalogue crawl without re-paying for duplicates.

# Actor input Schema

## `mode` (type: `string`):

search = provide search terms and filters. url = paste product, category, or search URLs and walk them.

## `searchTerms` (type: `array`):

One or more keywords to search, e.g. shirt, towel, kids toys.

## `sortBy` (type: `string`):

Order of results within each search.

## `specialsCategory` (type: `string`):

Limit results to a promotional collection. On sale keeps reduced products with a strike-through was-price; Clearance keeps run-out lines; New arrivals keeps the latest range. Combine with search terms to scope a promo to a keyword, or leave the terms empty to walk the whole promo collection.

## `brand` (type: `string`):

Filter to one brand (exact facet value, e.g. Target Woman).

## `colour` (type: `string`):

Filter to one colour (exact facet value, e.g. White).

## `minPrice` (type: `integer`):

Only keep products at or above this price.

## `maxPrice` (type: `integer`):

Only keep products at or below this price.

## `urls` (type: `array`):

Paste product, category, or search URLs from target.com.au. Multi-URL supported. Filter fields still apply.

## `fetchReviews` (type: `boolean`):

Attach ratings, review stats and individual reviews to each product (detail enrichment).

## `maxReviews` (type: `integer`):

Cap on reviews captured per product. 0 disables reviews.

## `maxItems` (type: `integer`):

Total products to return across all searches or URLs. 0 = unlimited.

## `maxPages` (type: `integer`):

Safety cap on pages walked per search term or category. 0 = walk every page (the run still stops naturally once the storefront's own result total is reached or a page repeats).

## `resumeFromRunId` (type: `string`):

Optional. ID of a previous run of this actor (or a dataset ID). Products already in that dataset are skipped, so this run returns only NEW products (a delta). Combine both runs' datasets for the full set. Max products then counts only the new products.

## `proxy` (type: `object`):

Apify Proxy configuration. The default automatic (datacenter) pool works well; residential is used only as a reliability fallback.

## `mcpConnectors` (type: `array`):

Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify then Settings then API & Integrations, then select it here. Notion gets a page-per-item export; other connectors get a best-effort write. Leave empty to skip. Supported: Notion, Linear, Airtable, Apify.

## `notionParentPageUrl` (type: `string`):

URL or id of the Notion page under which item pages are created. Required only for the Notion export.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "searchTerms": [
    "shirt"
  ],
  "sortBy": "relevance",
  "specialsCategory": "",
  "urls": [
    "https://www.target.com.au/search?text=shirt"
  ],
  "fetchReviews": true,
  "maxReviews": 20,
  "maxItems": 20,
  "maxPages": 0,
  "proxy": {
    "useApifyProxy": true
  },
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "searchTerms": [
        "shirt"
    ],
    "urls": [
        "https://www.target.com.au/search?text=shirt"
    ],
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/target-au-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchTerms": ["shirt"],
    "urls": ["https://www.target.com.au/search?text=shirt"],
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/target-au-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchTerms": [
    "shirt"
  ],
  "urls": [
    "https://www.target.com.au/search?text=shirt"
  ],
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call abotapi/target-au-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=abotapi/target-au-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/SUJoKU9seyWFuicrf/builds/dOdoRtgZvV0fuSePP/openapi.json
