cityelectricsupply.com APIcityelectricsupply.com ↗
Search CES products, browse categories, get stock levels with ZIP-code pricing, and manage a guest cart via 7 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/c90a7a77-36a8-4c15-a0a2-bdf3a9102a54/search_products?limit=5&query=wire+connector' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword, SKU, or part number. Returns paginated results with filters, sort options, and total match count. Supports localized pricing and inventory if zipcode is provided.
| Param | Type | Description |
|---|---|---|
| page | integer | Page index (0-based) |
| limit | integer | Number of results per page |
| queryrequired | string | Search keyword, SKU, or part number |
| zipcode | string | 5-digit US ZIP code for localized pricing and inventory |
{
"type": "object",
"fields": {
"productSearchResult": "object containing totalMatches, localStockMatches, returnedMatches, sortOptions, attributeFilters, and products array"
},
"sample": {
"data": {
"productSearchResult": {
"products": [
{
"basePrice": 18.68,
"productId": 160698,
"stockCode": "0544-0020",
"productName": "Large Waterproof Wire Connector, 10 Count"
}
],
"sortOptions": [
{
"sortId": 0,
"sortName": "Best Match"
}
],
"totalMatches": 1165,
"returnedMatches": 5,
"localStockMatches": 0
}
},
"status": "success"
}
}About the cityelectricsupply.com API
The City Electric Supply API gives developers access to 7 endpoints covering CES's electrical product catalog, including search_products for keyword and SKU lookups, category browsing, detailed product specs, localized stock levels by ZIP code, and a guest cart that persists across add and retrieve calls. Each product response includes stockCode, basePrice, specifications, and both local and network inventory quantities.
Search and Product Data
The search_products endpoint accepts a query string (keyword, SKU, or part number) plus an optional zipcode to return localized pricing and inventory. Results include a productSearchResult object with totalMatches, localStockMatches, returnedMatches, attributeFilters for faceted navigation, and a paginated products array. Pagination is 0-based via the page and limit parameters.
The get_product_details endpoint accepts any of product_id, slug, or stock_code (at least one required) and returns the full product record: productName, stockCode, basePrice, specifications (name/value pairs), images (with multiple size URLs), categories, and a stock object containing locationId, quantity, and networkQuantity. Providing a zipcode scopes stock and pricing to the nearest CES branch.
Category Navigation
list_categories returns the full top-level category tree in one call — no pagination — with categoryId, categoryName, urlSlug, and imagePathSmall for each entry. get_category_details drills into a single category by category_id or slug, returning its direct childCategories with their own IDs, names, slugs, and image URLs. To list products inside a category, pass the category_id or slug to get_category_products, which shares the same paginated productSearchResult shape as the search endpoint and also accepts a zipcode.
Guest Cart Management
The add_to_cart endpoint takes a product_id and an optional quantity, returning a status string confirming the operation. The cart persists within the same session. get_cart returns the full cart state: an items array with productId, productName, quantity, price, subtotal, stockCode, and per-item stock levels, plus a summary with subtotal, discountedSubtotal, applied discounts, selectedItemCount, and an isFreeShipping flag. A headerSummary object provides a lightweight itemCount and total for UI badge use.
- Build a procurement tool that queries search_products by SKU and checks localStockMatches for nearest-branch availability before ordering
- Sync a distributor's inventory feed using get_product_details with stock_code identifiers and networkQuantity for warehouse-wide availability
- Generate a category sitemap by walking list_categories and get_category_details to enumerate all CES product tree nodes
- Display localized electrical supply pricing in a field-service mobile app by passing the job-site zipcode to get_category_products
- Automate quote generation by adding matched products to a guest cart via add_to_cart and reading discountedSubtotal from get_cart
- Feed product specifications and images into a PIM system using the specifications array and images URLs returned by get_product_details
- Build a part-number resolver that accepts a stock_code and returns full product metadata including categories and basePrice
| 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 City Electric Supply offer an official developer API?+
How does ZIP code affect the data returned by search and product endpoints?+
zipcode is provided to search_products, get_product_details, or get_category_products, the response includes branch-specific stock via the stock object (locationId, quantity) and locally adjusted pricing via basePrice. Without a ZIP code the responses still return catalog data and networkQuantity (chain-wide stock), but branch-level availability is not scoped.What does the cart session cover, and are saved/named carts supported?+
add_to_cart accepts a product_id and optional quantity, and get_cart returns items, line-level pricing, applied discounts, and an isFreeShipping flag. Named or saved carts tied to a CES account are not currently exposed. The API covers guest cart creation and retrieval. You can fork it on Parse and revise to add account-based cart or order-history endpoints.Can I retrieve product reviews or customer ratings through this API?+
How deep does category navigation go — can I retrieve the full subcategory tree in one call?+
list_categories returns all top-level categories in a single call, but childCategories is empty at the root level. To get subcategories you call get_category_details for each parent, which returns its direct children. There is no single endpoint that returns the full nested tree to arbitrary depth. You can fork it on Parse and revise to add a recursive tree-builder endpoint if your use case requires full-depth traversal in one request.