# Tractor Supply Product Scraper (`sian.agency/tractor-supply-product-scraper`) Actor

Scrape Tractor Supply products — price, ratings, images, specs & availability. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.

- **URL**: https://apify.com/sian.agency/tractor-supply-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 $4.75 / 1,000 overview products

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

## Tractor Supply Product Scraper — Prices, Specs & Availability 🚜

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?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) [![Walmart Product Scraper](https://img.shields.io/badge/Store-Walmart%20Product%20Scraper-0071CE)](https://apify.com/sian.agency/walmart-data-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 Tractor Supply prices, promotions, ratings, and specs — by keyword or category, no code
##### Built for farm & ranch retailers, e-commerce sellers, and brands who need fresh Tractor Supply product data on demand

---

### 📋 Overview

**Track every price, promotion, and product spec on Tractor Supply — without writing a single line of code.** This scraper turns any Tractor Supply search or category into a clean, structured spreadsheet of products, complete with prices, ratings, images, and full specifications.

**Why thousands of professionals choose us:**
- ✅ **Complete product data**: 25+ fields per product — price, list price, promotions, rating, review count, brand, manufacturer, part number, and more
- ⚡ **Fast search-first mode**: pull dozens of products per page in seconds; scale to thousands across multiple searches
- 🎯 **Farm & ranch coverage**: poultry, livestock, horse, pet, lawn & garden, fencing, outdoor power equipment — the full rural assortment
- 💰 **Pay only for results**: charged per product you actually receive — no wasted spend, free tier to test
- 💎 **Detail enrichment**: add the full specifications table and long product description with one switch
- ✨ **NEW**: search by keyword *or* category, sort by best-sellers, price, name, or rating — just like the Tractor Supply site

---

### ✨ Features

- 🔎 **Keyword & Category Search**: scrape any Tractor Supply search term or category
- 🏷️ **Full Pricing**: current price, original/list price, promotion flags, and active offers
- ⭐ **Ratings & Reviews**: star rating and total review count for every product
- 📦 **Availability**: buyable status and availability (online / in-store) for each product
- 🖼️ **Product Images**: product image URLs, ready for catalogs or feeds
- 🧾 **Specifications Table**: full structured specs (Detail mode) — animal type, weight, materials, ingredients, and more
- 🏭 **Brand & Manufacturer**: brand, manufacturer, part number, and manufacturer part number for matching across catalogs
- 🗂️ **Category Mapping**: the product's parent category ids for clean classification
- 📤 **Clean Export**: results delivered as structured JSON or CSV, ready for Excel or your database
- 🚀 **No-Code Setup**: configure searches in a simple form — no scripts, no maintenance

---

### 🎬 Quick Start

Enter one or more search keywords, pick a mode, and run. In under a minute you'll have a structured dataset of Tractor Supply products you can download as JSON or CSV. No setup, no code.

```bash
curl -X POST https://api.apify.com/v2/acts/sian.agency~tractor-supply-product-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"keywords": ["chicken feed"], "scrapeMode": "overview"}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Add Your Searches

Type one or more Tractor Supply search keywords (e.g. `chicken feed`, `electric fence charger`) — one per line.

#### Step 2: Choose Your Mode

Pick **Overview** for fast search results, or **Detail** to also pull the full specifications table and long description.

#### Step 3: Run & Download

Click **Start**, then export your results as JSON, CSV, or Excel from the Apify dataset.

**That's it! In just a few minutes, you'll have:**

- A clean table of Tractor Supply products with prices and promotions
- Ratings, review counts, and product images
- Availability and full specifications for your chosen products

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| keywords | array | No | Tractor Supply search terms, one per item (e.g. `chicken feed`) |
| categoryIds | array | No | Advanced — Tractor Supply numeric category ids to harvest a whole category |
| scrapeMode | string | No | `overview` (fast search) or `detail` (adds specs table + long description) |
| sort | string | No | `relevance`, `name_asc`, `name_desc`, `price_low`, `price_high`, `top_sellers`, or `top_rated` |
| storeId | string | No | Tractor Supply store ID for localized price + availability (default `10151`) |
| maxResults | integer | No | Maximum products to return across all searches |

**Example — fast search:**

```json
{
  "keywords": ["chicken feed", "dog food"],
  "scrapeMode": "overview",
  "sort": "top_sellers",
  "maxResults": 100
}
```

**Example — full detail with specs:**

```json
{
  "keywords": ["horse wormer"],
  "scrapeMode": "detail",
  "storeId": "10151",
  "sort": "top_rated",
  "maxResults": 50
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **25+ fields per product**, including:

| Field | Type | Description |
|-------|------|-------------|
| productTitle | string | Product name |
| brand | string | Product brand |
| manufacturer | string | Manufacturer / parent brand |
| part\_number | string | Tractor Supply SKU / part number |
| price | number | Current price |
| original\_price | number | List/was price |
| on\_promotion | boolean | Whether the product is currently on promotion |
| promotions | array | Active promotional offers |
| rating | number | Average star rating |
| review\_count | number | Total number of reviews |
| buyable | boolean | Whether the product can be purchased |
| availability | string | Availability status (e.g. Online Only) |
| product\_group | string | High-level product grouping (e.g. Food/Feed) |
| images | array | All product image URLs |
| specs | object | Full specifications table (Detail mode) |
| description | string | Long product description (Detail mode) |

**Example:**

```json
{
  "product_id": "552395",
  "productTitle": "DuMOR Chicken Layer Pellet, 50 lb.",
  "brand": "DuMOR",
  "manufacturer": "DuMOR",
  "part_number": "135276099",
  "price": 19.99,
  "original_price": 22.99,
  "on_promotion": true,
  "promotions": ["Save 5% on Autoship future orders."],
  "rating": 4.6,
  "review_count": 1284,
  "buyable": true,
  "availability": "Online Only",
  "product_group": "Food/Feed",
  "images": ["https://media.tractorsupply.com/is/image/TractorSupplyCompany/..."],
  "specs": { "Animal Type": "Chickens", "Animal Life Stage": "Adult", "Feed Form": "Pellet" },
  "description": "A complete layer feed formulated for laying hens..."
}
```

***

### 💼 Use Cases & Examples

#### 1. Price Monitoring

**Retailers and resellers tracking Tractor Supply prices over time to stay competitive.**

**Input:** Your product keywords and a daily schedule
**Output:** Current price, list price, and promotion flags for every match
**Use:** Spot price drops, react to promotions, and keep your own pricing sharp.

#### 2. Competitive Analysis

**Brands and category managers benchmarking their products against the Tractor Supply assortment.**

**Input:** Category keywords and a target store
**Output:** Competitor prices, ratings, review counts, and promotion activity
**Use:** Understand where you win or lose on price, rating, and availability.

#### 3. Catalog Building

**E-commerce teams and marketplaces building a clean product catalog with images and specs.**

**Input:** Keywords or category ids, in Detail mode
**Output:** Titles, brands, manufacturers, part numbers, images, and full specifications tables
**Use:** Populate your storefront or PIM with structured, ready-to-use product data.

#### 4. MAP Compliance Monitoring

**Manufacturers enforcing Minimum Advertised Price policies across Tractor Supply listings.**

**Input:** Your branded product keywords
**Output:** Live listed prices and promotional offers per product
**Use:** Detect MAP violations quickly and protect your brand pricing.

#### 5. Assortment & Availability Research

**Merchandisers studying which farm & ranch products carry the best ratings and availability.**

**Input:** Category keywords and one or more store IDs
**Output:** Availability, buyable status, and rating data per product
**Use:** Plan assortment, identify gaps, and find top-rated products in a category.

#### 6. Market Research & Trend Spotting

**Analysts and researchers tracking best-sellers and review momentum in the rural goods market.**

**Input:** Broad category keywords, sorted by top sellers or top rated
**Output:** Best-seller mix, rating trends, and review-count growth
**Use:** Surface emerging products and category trends before competitors do.

***

### 🔗 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/tractor-supply-product-scraper').call({
  keywords: ['chicken feed'],
  scrapeMode: 'overview'
});

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/tractor-supply-product-scraper').call(
    run_input={'keywords': ['chicken feed'], 'scrapeMode': 'overview'}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~tractor-supply-product-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"keywords": ["chicken feed"], "scrapeMode": "overview"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: Schedule (e.g. daily) or webhook
2. **HTTP Request**: Call the actor API with your keywords
3. **Process**: Handle the JSON results
4. **Action**: Save to a sheet, sync to a database, or send a price-drop alert

***

### 📊 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
- Run multiple searches and large categories 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.

🔗 [View current pricing](https://apify.com/sian.agency/tractor-supply-product-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: How many products can I scrape?**
A: FREE tier: 25 products per run. PAID tier: unlimited products across as many searches as you like.

**Q: Can I get prices for a specific store?**
A: Yes — set the `storeId` to any Tractor Supply store to localize pricing and availability.

**Q: What's the difference between Overview and Detail mode?**
A: Overview is the fast path — search results with price, ratings, images, and availability. Detail adds the full specifications table and the long product description for every product.

**Q: What output formats are available?**
A: JSON, CSV, and Excel — export directly from the Apify dataset.

**Q: Can I scrape by category instead of keywords?**
A: Yes — use the `categoryIds` field with a Tractor Supply category id to scrape a whole category.

**Q: Is this legal?**
A: Yes — we only extract publicly available product data. See the legal section below.

**Q: How fresh is the data?**
A: Every run pulls live data directly from Tractor Supply at the moment you run it. Schedule runs to keep prices and availability up to date.

***

### 🐞 Troubleshooting

**No results returned**

- Check that your keywords match real Tractor Supply products
- Try a broader search term or a different sort order

**Missing specifications or description**

- Specs and long descriptions only appear in **Detail** mode — switch `scrapeMode` to `detail`

**Missing price on some products**

- Some products (multi-size bundles and bulk totes) show a price range on-site and have no single overview price — switch to **Detail** mode to capture per-size pricing

**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 extract what is publicly shared. 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.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

***

### ⚖️ Trademark Disclaimer

Tractor Supply® and Tractor Supply Co.® are trademarks of Tractor Supply Company. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Tractor Supply Company.

***

### ⭐ Love This Tool?

If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/tractor-supply-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
- 📧 <apify@sian-agency.online>

#### More from SIÁN Agency

- 🪚 [Home Depot Product Scraper](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) — Home Depot prices, specs & store stock
- 🏪 [Walmart Product Scraper](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) — Walmart product and review data
- 🛍️ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) — compare prices across every Google Shopping seller

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Actor input Schema

## `keywords` (type: `array`):

🔍 **KEYWORD SEARCH:** Free-text Tractor Supply searches — exactly what you'd type into the site's search bar.

📝 **EXAMPLES:** `chicken feed` · `dog food` · `electric fence charger` · `horse wormer` · `5 gallon bucket`

💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset.

🖊️ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line).

✅ **IMPORTANT:** Provide either keywords OR category ids (at least one is needed to have something to scrape).

## `categoryIds` (type: `array`):

🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Tractor Supply category instead of a keyword search.

🔧 **HOW TO GET IT:** Open any Tractor Supply category page (e.g. Poultry, Livestock, Horse) and copy the numeric category id from the page data. Paste just the numeric id here (e.g. `1004401`).

💡 **TIP:** Leave this empty if you're only using keywords — it's purely an advanced alternative for category-level harvesting.

🖊️ **BULK EDIT:** Add one category id per line to sweep multiple categories in a single run.

## `scrapeMode` (type: `string`):

⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product.

⚡ **Overview (fast):** Search results — price, ratings, images, brand/manufacturer and availability. Fastest and cheapest path.

🔬 **Detail (enriched specs):** Everything in Overview PLUS the full specifications table and the long product description from each product page.

💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons.

## `sort` (type: `string`):

🔃 **RESULT ORDERING:** Order search results using Tractor Supply's own native sort options — so you get the same ranking real shoppers see.

🎯 **Best match** is the default relevance order · 🔤 **Name** sorts A→Z or Z→A · 💲 **Price** sorts ascending or descending · 🏆 **Top sellers** surfaces the most popular products first · ⭐ **Top rated** leads with the highest-reviewed items.

## `storeId` (type: `string`):

🏬 **LOCALIZED PRICING & AVAILABILITY:** The Tractor Supply store id used to localize prices and report availability.

💡 **TIP:** Leave the default (`10151`) for representative US pricing, or set a specific store id to mirror what a nearby shopper sees.

## `maxResults` (type: `integer`):

🔢 **RESULT CAP:** Maximum number of products to return across all keywords and categories combined.

🎁 **TIER-BASED LIMITS:**

- **FREE users:** Up to 25 products per run
- **PAID users:** Unlimited — scrape entire catalogs in a single run

💡 **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right.

## Actor input object example

```json
{
  "keywords": [
    "chicken feed"
  ],
  "scrapeMode": "overview",
  "sort": "relevance",
  "storeId": "10151",
  "maxResults": 100
}
```

# Actor output Schema

## `tractorSupplyProducts` (type: `string`):

Scraped Tractor Supply products with prices, promotions, ratings, images, specs and availability.

# 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 = {
    "keywords": [
        "chicken feed"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/tractor-supply-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["chicken feed"] }

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/tractor-supply-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 '{
  "keywords": [
    "chicken feed"
  ]
}' |
apify call sian.agency/tractor-supply-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sian.agency/tractor-supply-product-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Tractor Supply Product Scraper",
        "description": "Scrape Tractor Supply products — price, ratings, images, specs & availability. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.",
        "version": "1.0",
        "x-build-id": "Vya1hD1pvTZrhW6M8"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~tractor-supply-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-tractor-supply-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~tractor-supply-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-tractor-supply-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~tractor-supply-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-tractor-supply-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": {
                    "keywords": {
                        "title": "🔍 Search Keywords",
                        "type": "array",
                        "description": "🔍 **KEYWORD SEARCH:** Free-text Tractor Supply searches — exactly what you'd type into the site's search bar.\n\n📝 **EXAMPLES:** `chicken feed` · `dog food` · `electric fence charger` · `horse wormer` · `5 gallon bucket`\n\n💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset.\n\n🖊️ **BULK EDIT:** Click \"Bulk edit\" to paste many keywords at once (one per line).\n\n✅ **IMPORTANT:** Provide either keywords OR category ids (at least one is needed to have something to scrape).",
                        "default": [
                            "chicken feed"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "categoryIds": {
                        "title": "🧭 Category IDs (Advanced)",
                        "type": "array",
                        "description": "🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Tractor Supply category instead of a keyword search.\n\n🔧 **HOW TO GET IT:** Open any Tractor Supply category page (e.g. Poultry, Livestock, Horse) and copy the numeric category id from the page data. Paste just the numeric id here (e.g. `1004401`).\n\n💡 **TIP:** Leave this empty if you're only using keywords — it's purely an advanced alternative for category-level harvesting.\n\n🖊️ **BULK EDIT:** Add one category id per line to sweep multiple categories in a single run.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "scrapeMode": {
                        "title": "⚙️ Scrape Mode",
                        "enum": [
                            "overview",
                            "detail"
                        ],
                        "type": "string",
                        "description": "⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\n⚡ **Overview (fast):** Search results — price, ratings, images, brand/manufacturer and availability. Fastest and cheapest path.\n\n🔬 **Detail (enriched specs):** Everything in Overview PLUS the full specifications table and the long product description from each product page.\n\n💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons.",
                        "default": "overview"
                    },
                    "sort": {
                        "title": "🔃 Sort Order",
                        "enum": [
                            "relevance",
                            "name_asc",
                            "name_desc",
                            "price_low",
                            "price_high",
                            "top_sellers",
                            "top_rated"
                        ],
                        "type": "string",
                        "description": "🔃 **RESULT ORDERING:** Order search results using Tractor Supply's own native sort options — so you get the same ranking real shoppers see.\n\n🎯 **Best match** is the default relevance order · 🔤 **Name** sorts A→Z or Z→A · 💲 **Price** sorts ascending or descending · 🏆 **Top sellers** surfaces the most popular products first · ⭐ **Top rated** leads with the highest-reviewed items.",
                        "default": "relevance"
                    },
                    "storeId": {
                        "title": "🏬 Store ID",
                        "type": "string",
                        "description": "🏬 **LOCALIZED PRICING & AVAILABILITY:** The Tractor Supply store id used to localize prices and report availability.\n\n💡 **TIP:** Leave the default (`10151`) for representative US pricing, or set a specific store id to mirror what a nearby shopper sees.",
                        "default": "10151"
                    },
                    "maxResults": {
                        "title": "🔢 Max Results",
                        "minimum": 1,
                        "type": "integer",
                        "description": "🔢 **RESULT CAP:** Maximum number of products to return across all keywords and categories combined.\n\n🎁 **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited — scrape entire catalogs in a single run\n\n💡 **TIP:** Keep this low while you dial in your keywords, 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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```