sparkfun.com APIsparkfun.com ↗
Access SparkFun's electronics catalog via API. Search products, retrieve pricing, bulk tiers, stock status, category hierarchy, and today's deals.
curl -X GET 'https://api.parse.bot/scraper/13fda662-fc79-49a7-a8b2-70033f773694/search_products?query=arduino' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword in SparkFun's catalog. Returns paginated results with product name, price, URL, slug, and thumbnail image.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination. |
| limit | string | Items per page. Accepted values: 12, 24, 36, 48, all. |
| queryrequired | string | Search keyword (e.g. 'arduino', 'sensor'). |
| sort_by | string | Sort field. Accepted values: name, price, sf_golive_date, relevance. |
{
"type": "object",
"fields": {
"page": "current page number",
"limit": "items per page",
"query": "search keyword echoed back",
"products": "array of product summaries, each with name, sku, url, slug, price, image_url",
"total_results": "total number of matching products"
},
"sample": {
"data": {
"page": 1,
"limit": 24,
"query": "arduino",
"products": [
{
"sku": null,
"url": "https://www.sparkfun.com/arduino-fio.html",
"name": "Arduino Fio",
"slug": "arduino-fio",
"price": "$10.83",
"image_url": "https://www.sparkfun.com/media/catalog/product/cache/df4360b598d6f0c75fa659693b376bad/1/0/10116-01.jpg"
}
],
"total_results": 468
},
"status": "success"
}
}About the sparkfun.com API
The SparkFun API covers 6 endpoints that expose product search, full product details, live pricing, stock status, category browsing, and daily deals from SparkFun's electronics catalog. The get_product_details endpoint alone returns 10 fields per product including bulk pricing tiers, review count, and image arrays. Whether you're building a parts-sourcing tool or a price tracker, the API gives structured access to SparkFun's full catalog.
Search and Browse the Catalog
The search_products endpoint accepts a query string and returns paginated results including each product's name, sku, price, slug, and image_url. Pagination is controlled with page and limit (accepted values: 12, 24, 36, 48, or all), and results can be sorted by name, price, sf_golive_date, or relevance. The browse_category endpoint works the same way but scopes results to a specific category — supply a category_slug obtained from list_all_categories, which returns the full SparkFun category hierarchy including nested subcategories, each with its own slug and url.
Product Detail and Pricing
Passing a product slug to get_product_details returns the full data set for that item: sku, name, price, description, images array, rating (out of 5, or null if unrated), review_count, price_tiers for bulk purchasing, and an internal product_id. The get_product_pricing_and_stock endpoint is a focused alternative — it returns the same price, price_tiers, and sku fields, plus a stock_status string and a stock_details object with extended availability data. Use this endpoint when you need current availability without fetching the full product description.
Deals and Promotions
The get_todays_deals endpoint takes no inputs and returns the current set of discounted products from SparkFun's Today's Deals page. Each deal item includes name, sku, url, slug, price, and image_url — the same shape as search and category results, making it straightforward to integrate deal monitoring into an existing product pipeline.
- Track price changes on specific SparkFun SKUs by polling
get_product_pricing_and_stockon a schedule - Build a parts sourcing tool that searches SparkFun by component keyword and returns in-stock items with pricing
- Aggregate bulk pricing tiers from
price_tiersto calculate cost at different order quantities - Monitor
get_todays_dealsdaily to surface discounted components for a deal alert service - Construct a full category tree using
list_all_categoriesto build a site mirror or internal catalog browser - Compare SparkFun product ratings and review counts across similar components using
get_product_details
| 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 | 250 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 SparkFun have an official developer API?+
What does `get_product_details` return that `get_product_pricing_and_stock` does not?+
get_product_details returns the full description text, the images array, rating, review_count, and an internal product_id alongside pricing fields. get_product_pricing_and_stock returns only name, sku, price, price_tiers, stock_status, and stock_details — useful when description content is not needed and you want a lighter response.Does the API expose customer review text or only aggregate ratings?+
rating (average out of 5) and review_count from get_product_details. Individual review text and reviewer metadata are not included. You can fork the API on Parse and revise it to add an endpoint that retrieves per-review content.How does pagination work across search and category endpoints?+
search_products and browse_category accept page and limit parameters. The limit parameter accepts only discrete values: 12, 24, 36, 48, or all. search_products also echoes back total_results so you can calculate how many pages exist. browse_category does not currently return a total_results field in its response.