Harbor Freight APIharborfreight.com ↗
Search Harbor Freight Tools products via API. Get real-time pricing, sale flags, review ratings, brand facets, and category data for any tool query.
What is the Harbor Freight API?
The Harbor Freight Tools API exposes one endpoint, search_products, that returns up to 36 product listings per page across Harbor Freight's full tool catalog. Each response includes 14+ fields per product: SKU, name, brand, URL, image, current price, regular price, currency, on-sale flag, rating, review count, and resolved category. Brand and category facets are returned alongside results for downstream filtering.
curl -X GET 'https://api.parse.bot/scraper/701b14f9-61c8-4a0e-bb0b-2aa9a1a236a7/search_products?page=1&query=wrench&page_size=5&include_reviews=true' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace harborfreight-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.harbor_freight_product_search_api import HarborFreight, Product
client = HarborFreight()
for product in client.products.search(query="welding gloves", page_size=10, limit=5):
print(product.sku, product.name, product.brand, product.price, product.rating, product.review_count)
Search for products on Harbor Freight. Returns paginated product listings with pricing, reviews, brand info, variants, member deals, and category/brand facets for filtering. Handles keyword-to-category redirects automatically. Each page includes brand and category facets alongside the product list. Paginates via integer page counter; the SDK auto-advances pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search query (e.g., 'drill', 'welding gloves', 'wrench set') |
| page_size | integer | Number of results per page (max 36) |
| include_reviews | string | Include review ratings and counts. Accepted values: 'true', 'false'. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"query": "string - the search query used",
"brands": "array of brand facet objects with name and count",
"category": "string or null - resolved category name if search redirected to a category",
"products": "array of product objects with sku, name, brand, url, image_url, price, regular_price, currency, on_sale, rating, review_count, and optional compare/variant info",
"page_size": "integer - results per page",
"categories": "array of category facet objects with name, id, and count",
"total_count": "integer - total number of matching products",
"total_pages": "integer - total pages available",
"auto_corrected_query": "string or null - auto-corrected query if spelling was adjusted"
},
"sample": {
"data": {
"page": 1,
"query": "drill",
"brands": [
{
"name": "HERCULES",
"count": 136
}
],
"category": "Drills, Drivers & Drill Presses",
"products": [
{
"sku": "73238",
"url": "https://www.harborfreight.com/20v-2-tool-drill-impact-driver-kit-73238.html",
"name": "20V 2-Tool Drill & Impact Driver Kit",
"brand": "BAUER",
"price": 99.99,
"is_new": false,
"rating": 4.8,
"on_sale": false,
"currency": "USD",
"image_url": "https://www.harborfreight.com/media/catalog/product/cache/aa6c321fb362164a2ed76c30e077c9a9/7/3/73238_W3.jpg",
"retail_only": false,
"review_count": 19,
"regular_price": 99.99,
"compare_savings": "$199.01",
"compare_at_brand": "DEWALT",
"compare_at_price": 299,
"eligible_channel": "All"
}
],
"page_size": 5,
"categories": [
{
"id": "2636",
"name": "Drill & Driver Bits",
"count": 211
}
],
"total_count": 121,
"total_pages": 25,
"auto_corrected_query": null
},
"status": "success"
}
}About the Harbor Freight API
What search_products Returns
The search_products endpoint accepts a query string — anything from 'drill' to 'welding gloves' — and returns a paginated list of matching products. Each product object includes sku, name, brand, url, image_url, price, regular_price, currency, on_sale, rating, and review_count. The on_sale flag and the difference between price and regular_price let you detect active discounts without additional parsing.
Facets and Category Handling
Every response includes two facet arrays: brands (each with name and count) and categories (each with name, id, and count). These allow you to build filter UIs or narrow subsequent queries programmatically. If Harbor Freight's own search logic redirects a keyword to a specific department, the category field in the response will contain the resolved category name rather than null.
Pagination and Query Correction
Use page and page_size (maximum 36) to walk through results. total_count and total_pages tell you the full result set size upfront. The auto_corrected_query field will be non-null when the search engine applied a spelling correction, so you can surface that correction in your own UI rather than silently using the corrected term.
Review Data
Pass include_reviews=true to attach rating and review_count to each product. If you don't need that data and want a leaner response, pass include_reviews=false. This is the only optional toggle on the endpoint.
The Harbor Freight API is a managed, monitored endpoint for harborfreight.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when harborfreight.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official harborfreight.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track sale prices on specific tool categories by comparing
pricevsregular_priceacross daily snapshots - Build a Harbor Freight deal-finder that surfaces all products where
on_saleis true for a given query - Aggregate brand coverage across a product category using the
brandsfacet array - Monitor
review_countandratingchanges over time to detect trending or newly reviewed products - Populate a tool comparison table with SKU, price, rating, and image data for a specific search term
- Identify category redirects by checking the
categoryfield to understand how Harbor Freight classifies a keyword
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Harbor Freight have an official developer API?+
What does the `auto_corrected_query` field contain, and when is it set?+
null when your original query was used as-is. This lets you distinguish between results for your intended term and results for a silently corrected one.Does the API return individual product detail pages, specifications, or inventory status?+
Are member pricing or club deal prices included in the response?+
price and regular_price. If a product has a member-specific discount, that information is included in the product object when available.What is the maximum number of results I can retrieve per request, and how do I paginate?+
page_size parameter caps at 36 results per request. Use page to advance through the result set, and use total_pages from the response to know when you've reached the last page. total_count gives you the full count of matching products across all pages.