Search the Zoro catalog on zoro.com by keyword or by a search or category URL.
Keyword
GET https://api.piloterr.com/v2/zoro/search?query=safety%20glasses
Page 2
GET https://api.piloterr.com/v2/zoro/search?query=safety%20glasses&page=2
Category URL
GET https://api.piloterr.com/v2/zoro/search?query=https://www.zoro.com/safety-glasses/c/6214/
| Parameter |
Type |
Required |
Default |
What to pass |
What changes in the JSON |
query |
string |
yes |
empty, which returns 400 |
A keyword, a Zoro search URL, or a category URL |
A keyword builds /search?q=.... Each card has price as a USD number and price_display as the dollar string. A product URL returns 400. |
page |
integer |
no |
omit for page 1 |
An integer from 1 |
Page 2 adds page=2, sets pagination.page to 2, and returns the next cards. pagination.next is the next page URL, or null on the last page. |
return_page_source |
boolean |
no |
false |
true or false |
true replaces results and pagination with result, the rendered HTML. |
price is the unit amount. price_display is the label, such as $1.39. When the card is sold in multiples, package_quantity, package_price, and package_price_display are added. When Zoro prints an approximate count such as 3,000+, total_results is that floor and total_pages is null.
- Match a maintenance part to a Zoro number and unit price
- Walk a category with
pagination.next
| Code |
Meaning |
| 400 |
Empty query, a non-Zoro URL, a product URL, or a page below 1 |
| 404 |
The page did not contain product cards |
| 500 |
The page could not be rendered |