# Target Product Scraper (`sian.agency/target-product-scraper`) Actor Scrape Target product data by URL or TCIN โ€” brand, full specifications, every image, ratings, reviews, description, category & availability. Clean JSON/CSV/Excel export, no code. - **URL**: https://apify.com/sian.agency/target-product-scraper.md - **Developed by:** [SIรN Oรœ](https://apify.com/sian.agency) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 product extracteds 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Product Scraper โ€” Specs, Images, Ratings & Reviews ๐ŸŽฏ [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Walmart Product Scraper](https://img.shields.io/badge/Store-Walmart%20Product%20Scraper-0071CE)](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) [![Home Depot Product Scraper](https://img.shields.io/badge/Store-Home%20Depot%20Product%20Scraper-F96302)](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) [![Google Shopping Price Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Scraper-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) #### ๐ŸŽฏ Pull complete Target product data โ€” full specs, every image, ratings & reviews โ€” by product URL or TCIN, no code ##### Built for e-commerce teams, brands, catalog builders, and market researchers who need clean Target.com product data on demand --- ### ๐Ÿ“‹ Overview **Turn any Target product page into a clean, structured record โ€” no code, no account, no scraping headaches.** Give the Target Product Scraper a product URL or a TCIN (Target's catalog item number) and it returns the full picture: the complete specifications table, every product image, the average rating with its 1โ€“5 star breakdown, the long description, feature highlights, category trail, and availability โ€” all export-ready as JSON, CSV, or Excel. **Why professionals choose us:** - โœ… **Deep product records**: 30+ fields per product โ€” title, brand, DPCI, UPC, full specifications, images, ratings, reviews, description, category, and availability - ๐Ÿ–ผ๏ธ **Every product image**: the primary image plus the full gallery, ready for catalogs, feeds, and comparison pages - โญ **Ratings & reviews built in**: average rating, total review count, the full 1โ€“5 star distribution, and secondary rating breakdowns - ๐Ÿงพ **Complete specifications table**: structured spec pairs (dimensions, materials, features, and more) for every product - ๐Ÿ’ฐ **Pay only for results**: charged per product you actually receive โ€” no wasted spend, plus a free tier to test - โœจ **No account or API key needed**: paste URLs or TCINs, click Start, download your data --- ### โœจ Features - ๐Ÿ”— **URL or TCIN Input**: scrape by Target product-page URL, by bare TCIN, or mix both in one run - ๐Ÿงพ **Full Specifications Table**: structured spec pairs extracted straight from the product page - ๐Ÿ–ผ๏ธ **Complete Image Gallery**: primary image plus every alternate image URL - โญ **Ratings & Review Breakdown**: average rating, review count, and the full 1โ€“5 star distribution - ๐Ÿท๏ธ **Identifiers for Matching**: brand, DPCI, and UPC to line products up across catalogs and marketplaces - ๐Ÿ“ **Rich Descriptions**: the long product description, feature highlights, and desirability cues - ๐Ÿงญ **Category & Breadcrumbs**: the product's department, product type, category, and full breadcrumb trail - ๐Ÿ“ฆ **Availability Data**: in-stock status, availability label, and per-order purchase limit - ๐Ÿ’ฒ **Price Fields (when available)**: current price, list price, savings, and sale status populate whenever Target exposes them - ๐Ÿ“ค **Clean Export**: results delivered as structured JSON, CSV, or Excel โ€” ready for spreadsheets or your database --- ### ๐ŸŽฌ Quick Start Paste one or more Target product URLs or TCINs, set a max, and run. In under a minute you'll have a structured dataset of Target products you can download as JSON, CSV, or Excel. No setup, no account, no code. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~target-product-scraper/runs?token=YOUR_TOKEN \ -H 'Content-Type: application/json' \ -d '{"productUrls": ["https://www.target.com/p/-/A-94286946"]}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Add Your Products Paste one or more Target product-page URLs into **Product URLs**, and/or add Target **TCINs** โ€” one per line. You can mix both. #### Step 2: Set Your Cap Set **Max Results** to the number of products you want this run (FREE: up to 25, PAID: unlimited). #### Step 3: Run & Download Click **Start**, then export your results as JSON, CSV, or Excel straight from the Apify dataset. **That's it! In just a few minutes, you'll have:** - A clean table of Target products with specs, images, and identifiers - Ratings, review counts, and the full star-rating breakdown - Descriptions, category trails, and availability for every product *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | productUrls | array | No\* | Target product-page URLs (e.g. `https://www.target.com/p/-/A-94286946`), one per item | | tcins | array | No\* | Target catalog item numbers (TCINs) โ€” the 6โ€“9 digit product id, one per item | | maxResults | integer | No | Maximum products to return this run (FREE: up to 25, PAID: unlimited) | \* Provide **at least one** `productUrls` entry or `tcins` entry. **How to find a TCIN:** Open any Target product page. The TCIN is the number at the end of the URL after `/A-` โ€” for `target.com/p/-/A-94286946`, the TCIN is `94286946`. You'll also find it listed as **"TCIN"** in the product's *Specifications* section on the page. It's always a 6โ€“9 digit number. **Example โ€” by product URL:** ```json { "productUrls": [ "https://www.target.com/p/-/A-94286946", "https://www.target.com/p/-/A-79305641" ], "maxResults": 50 } ``` **Example โ€” by TCIN:** ```json { "tcins": ["94286946", "79305641", "88374915"], "maxResults": 100 } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **30+ fields per product**, including: | Field | Type | Description | |-------|------|-------------| | tcin | string | Target catalog item number | | productTitle | string | Product name/title | | brand | string | Product brand | | dpci | string | Target DPCI (Department-Class-Item) number | | upc | string | Universal Product Code / primary barcode | | specs | object | Full structured specifications table | | primary\_image | string | Main product image URL | | images | array | All product image URLs (full gallery) | | image\_count | number | Number of images returned | | rating | number | Average star rating | | review\_count | number | Total number of ratings | | written\_review\_count | number | Number of written reviews | | rating\_distribution | object | Count of 1โ˜…, 2โ˜…, 3โ˜…, 4โ˜…, 5โ˜… ratings | | secondary\_ratings | object | Secondary rating averages (e.g. quality, value) | | description | string | Long product description | | highlights | array | Key feature bullets | | features | array | Feature highlights / desirability cues | | category | string | Product category | | breadcrumbs | array | Full category breadcrumb trail | | product\_type | string | Product type | | department | string | Department name | | availability | string | Availability status label | | in\_stock | boolean | Whether the product is in stock | | purchase\_limit | number | Maximum quantity per order, where set | | price | number | Current price (populated when available) | | regular\_price | number | List/was price (populated when available) | | price\_formatted | string | Formatted price string (when available) | | on\_sale | boolean | Whether the product is on sale (when available) | | savings | number | Dollar savings vs. list price (when available) | | currency | string | Currency code (`USD`) | | url | string | Canonical Target product-page URL | **Example:** ```json { "thumbnail": "https://target.scene7.com/is/image/Target/GUEST_...", "tcin": "94286946", "productTitle": "Keurig K-Mini Single-Serve K-Cup Pod Coffee Maker", "brand": "Keurig", "dpci": "072-06-0123", "upc": "611247374375", "specs": { "Dimensions (Overall)": "12.1 inches (H) x 4.5 inches (W) x 11.3 inches (D)", "Capacity": "6 to 12 ounce", "Material": "Plastic", "Warranty": "1 year limited warranty" }, "primary_image": "https://target.scene7.com/is/image/Target/GUEST_...", "images": ["https://target.scene7.com/is/image/Target/GUEST_...", "..."], "image_count": 6, "rating": 4.7, "review_count": 21843, "written_review_count": 5120, "rating_distribution": { "1": 210, "2": 180, "3": 640, "4": 3200, "5": 17613 }, "secondary_ratings": { "quality": 4.6, "value": 4.5 }, "description": "Brew your favorite coffee, tea, hot cocoa or iced beverage...", "highlights": ["Fits anywhere โ€” less than 5 inches wide", "Brews 6 to 12oz cups"], "features": ["Highly rated", "Best seller"], "category": "Single-Serve Coffee Makers", "breadcrumbs": ["Kitchen & Dining", "Coffee Makers", "Single-Serve Coffee Makers"], "product_type": "Coffee Maker", "department": "Kitchen", "availability": "IN_STOCK", "in_stock": true, "purchase_limit": 10, "price": 59.99, "regular_price": 89.99, "price_formatted": "$59.99", "on_sale": true, "savings": 30.0, "currency": "USD", "url": "https://www.target.com/p/-/A-94286946" } ``` > **Note on price:** Target loads live pricing behind extra protection, so the price fields are best-effort โ€” they populate **when available** and may be blank for some products. The specifications, images, ratings, reviews, descriptions, category, and availability are the reliable core of every record. *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Catalog & Assortment Building **E-commerce teams and marketplaces building a clean product catalog with images and specs.** **Input:** A list of Target product URLs or TCINs **Output:** Titles, brands, DPCI, UPC, full specifications tables, and complete image galleries **Use:** Populate your storefront, PIM, or feed with structured, ready-to-use Target product data. #### 2. Competitor & Assortment Research **Brands and category managers benchmarking their products against Target's assortment.** **Input:** TCINs for the products you want to track **Output:** Ratings, review counts, star distributions, specifications, and availability **Use:** Understand how your products stack up on rating, spec, and availability across the category. #### 3. Ratings & Reviews Intelligence **Product and insights teams analyzing customer sentiment at scale.** **Input:** A batch of TCINs or product URLs **Output:** Average ratings, review counts, secondary rating breakdowns, and the full 1โ€“5 star distribution **Use:** Spot quality signals, compare products, and prioritize what to fix or promote. #### 4. Product-Spec Extraction for Feeds **Feed managers and content teams enriching product feeds with structured specifications.** **Input:** Product URLs for the items you're listing **Output:** Full specs tables, DPCI, UPC, descriptions, highlights, and images **Use:** Build complete, accurate product feeds and comparison pages at scale. #### 5. UPC & Identifier Matching **Data teams reconciling products across retailers and marketplaces.** **Input:** Target product URLs or TCINs **Output:** UPC, DPCI, brand, product type, and category for each item **Use:** Match Target products to your own SKUs, Amazon ASINs, or other retail catalogs. #### 6. Availability & Merchandising Checks **Merchandisers and ops teams confirming what's live on Target.** **Input:** A list of TCINs to monitor **Output:** In-stock status, availability label, and per-order purchase limits **Use:** Confirm availability, spot removed or out-of-stock items, and plan around purchase limits. *** ### ๐Ÿ”— Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/target-product-scraper').call({ productUrls: ['https://www.target.com/p/-/A-94286946'], }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/target-product-scraper').call( run_input={'tcins': ['94286946', '79305641']} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~target-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"productUrls": ["https://www.target.com/p/-/A-94286946"]}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule (e.g. daily) or webhook 2. **HTTP Request**: Call the actor with your product URLs or TCINs 3. **Process**: Handle the JSON results 4. **Action**: Save to a sheet, sync to a database, or update your catalog *** ### ๐Ÿ“Š Performance & Pricing #### FREE Tier (Try It Now) - **25 products** per run โ€” full feature access, same data quality - No credit card required - Perfect for testing and small projects #### PAID Tier (Production Ready) - **Unlimited** products per run - Process large URL and TCIN lists in one go - Pay-per-result: you're only charged for the products you actually receive ๐Ÿ’ฐ **Best value on the market** โ€” transparent pay-per-result pricing with no hidden subscription fees. You pay only for the products you receive. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/target-product-scraper?fpr=sian) *** ### โ“ Frequently Asked Questions **Q: How do I tell the scraper which products to get?** A: Paste Target product-page URLs into `productUrls`, and/or add Target TCINs into `tcins`. You can mix both in a single run. **Q: What is a TCIN and how do I find one?** A: A TCIN is Target's catalog item number โ€” a 6โ€“9 digit id. It's the number at the end of a product URL after `/A-` (e.g. `A-94286946` โ†’ `94286946`), and it's also listed as "TCIN" in the product's Specifications on the page. **Q: How many products can I scrape?** A: FREE tier: 25 products per run. PAID tier: unlimited products across as many URLs and TCINs as you like. **Q: Do I get the live price?** A: Price fields (current price, list price, savings, sale status) populate **when available**. Target protects live pricing, so a price can be blank for some products. The specifications, images, ratings, reviews, descriptions, and availability are delivered reliably for every product. **Q: Do I need a Target account or API key?** A: No. Just paste your URLs or TCINs and run โ€” no account, no API key, no login required. **Q: What output formats are available?** A: JSON, CSV, and Excel โ€” export directly from the Apify dataset. **Q: Is it legal to collect this data?** A: Yes โ€” the actor only collects publicly available product data that anyone can see on the product page. It does not collect private or personal user data. See the legal section below. **Q: How fresh is the data?** A: Every run pulls live data at the moment you run it. Schedule runs to keep your catalog and ratings up to date. *** ### ๐Ÿž Troubleshooting **"Not a target.com URL" or "Could not find a TCIN" error** - Use a full product-page URL copied from your browser (it contains `/A-`), or enter a bare 6โ€“9 digit TCIN **A product came back empty** - The item may be unavailable, removed, or temporarily unreachable โ€” double-check the URL/TCIN is live on Target.com **Price field is blank** - Target protects live pricing, so price is best-effort and can be blank for some products โ€” the specs, images, ratings, reviews, and availability are always the reliable core **Fewer results than expected on the free tier** - The FREE tier is capped at 25 products per run โ€” upgrade to PAID for unlimited results *** ### โš–๏ธ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only collect publicly available product information that anyone can see. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. Please also respect the target site's terms of use. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### โš–๏ธ Trademark Disclaimer "Target" and related marks are trademarks of **Target Brands, Inc.** This actor is an independent tool and is **not affiliated with, endorsed by, or sponsored by Target Brands, Inc.** It accesses only publicly available product-page data, and you should use it in line with Target's terms of use and all applicable laws. *** ### โญ Love This Tool? If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/target-product-scraper/reviews) โ€” it helps other professionals discover it and helps us keep improving. *** ### ๐Ÿค Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check the [SIรN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - ๐Ÿ“ง #### More by SIรN Agency - ๐Ÿช [Walmart Data Scraper](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) โ€” full Walmart product and review data - ๐Ÿ› ๏ธ [Lowe's Product Scraper](https://apify.com/sian.agency/lowes-product-scraper?fpr=sian) โ€” Lowe's prices, specs, ratings, and live in-store stock - ๐Ÿงฑ [Home Depot Product Scraper](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) โ€” Home Depot product data, specs, and pricing - ๐Ÿ›๏ธ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) โ€” compare prices across every Google Shopping seller - ๐Ÿ”Ž [Browse all SIรN actors โ†’](https://apify.com/sian.agency?fpr=sian) *** **Built by [SIรN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `productUrls` (type: `array`): ๐Ÿ”— **PRODUCT URLS:** Paste Target product-page URLs โ€” one per line. Each one is fetched and returned as a full product record. ๐Ÿ“‹ **EXAMPLE:** `https://www.target.com/p/-/A-94286946` ๐Ÿ”ง **HOW TO GET A URL:** 1. Open any product on [target.com](https://www.target.com) 2. Copy the link straight from your browser's address bar 3. Paste it here ๐Ÿ–Š๏ธ **BULK EDIT:** Click "Bulk edit" to paste many URLs at once (one per line), or upload a `.txt` file of URLs. ๐ŸŽ **TIER-BASED LIMITS:** - **FREE users:** Up to 25 products per run - **PAID users:** Unlimited โ€” scrape as many products as you need โœ… **IMPORTANT:** Provide either product URLs OR TCINs (at least one is needed to have something to scrape). ## `tcins` (type: `array`): ๐Ÿ”ข **TCIN INPUT (Advanced):** A TCIN is Target's 6โ€“9 digit catalog item number โ€” the number that appears in a product URL right after `/A-`. ๐Ÿ“‹ **EXAMPLE:** In `https://www.target.com/p/-/A-94286946` the TCIN is `94286946`. ๐Ÿ’ก **TIP:** This is a shortcut alternative to pasting full product URLs โ€” add one TCIN per line. ๐Ÿ–Š๏ธ **BULK EDIT:** Click "Bulk edit" to paste many TCINs at once (one per line). โœ… **IMPORTANT:** Provide either product URLs OR TCINs (at least one is needed to have something to scrape). ## `maxResults` (type: `integer`): ๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all URLs and TCINs combined. ๐ŸŽ **TIER-BASED LIMITS:** - **FREE users:** Up to 25 products per run - **PAID users:** Unlimited โ€” scrape as many products as you need in a single run ๐Ÿ’ก **TIP:** Keep this low while you test your inputs, then raise it once the output looks right. ## Actor input object example ```json { "tcins": [ "94286946" ], "maxResults": 100 } ``` # Actor output Schema ## `targetProducts` (type: `string`): Scraped Target products โ€” title, brand, DPCI, UPC, full specifications, every image, ratings and the star-distribution breakdown. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "tcins": [ "94286946" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/target-product-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "tcins": ["94286946"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/target-product-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 '{ "tcins": [ "94286946" ] }' | apify call sian.agency/target-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/target-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Target Product Scraper", "description": "Scrape Target product data by URL or TCIN โ€” brand, full specifications, every image, ratings, reviews, description, category & availability. Clean JSON/CSV/Excel export, no code.", "version": "1.0", "x-build-id": "mJY4bpg0H3e9v2bg5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~target-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-target-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~target-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-target-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~target-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-target-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "productUrls": { "title": "๐Ÿ”— Target Product URLs", "uniqueItems": true, "type": "array", "description": "๐Ÿ”— **PRODUCT URLS:** Paste Target product-page URLs โ€” one per line. Each one is fetched and returned as a full product record.\n\n๐Ÿ“‹ **EXAMPLE:** `https://www.target.com/p/-/A-94286946`\n\n๐Ÿ”ง **HOW TO GET A URL:**\n1. Open any product on [target.com](https://www.target.com)\n2. Copy the link straight from your browser's address bar\n3. Paste it here\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Click \"Bulk edit\" to paste many URLs at once (one per line), or upload a `.txt` file of URLs.\n\n๐ŸŽ **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited โ€” scrape as many products as you need\n\nโœ… **IMPORTANT:** Provide either product URLs OR TCINs (at least one is needed to have something to scrape).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "tcins": { "title": "๐Ÿ”ข Target TCINs (Advanced)", "type": "array", "description": "๐Ÿ”ข **TCIN INPUT (Advanced):** A TCIN is Target's 6โ€“9 digit catalog item number โ€” the number that appears in a product URL right after `/A-`.\n\n๐Ÿ“‹ **EXAMPLE:** In `https://www.target.com/p/-/A-94286946` the TCIN is `94286946`.\n\n๐Ÿ’ก **TIP:** This is a shortcut alternative to pasting full product URLs โ€” add one TCIN per line.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Click \"Bulk edit\" to paste many TCINs at once (one per line).\n\nโœ… **IMPORTANT:** Provide either product URLs OR TCINs (at least one is needed to have something to scrape).", "default": [ "94286946" ], "items": { "type": "string" } }, "maxResults": { "title": "๐Ÿ”ข Max Results", "minimum": 1, "type": "integer", "description": "๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all URLs and TCINs combined.\n\n๐ŸŽ **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited โ€” scrape as many products as you need in a single run\n\n๐Ÿ’ก **TIP:** Keep this low while you test your inputs, then raise it once the output looks right.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```