Piloterr

Zoro Search

GET
/v2/zoro/search

Search Zoro by keyword or category URL. Returns product cards with USD price, brand, Zoro number, and pagination.

Credit cost: 2 credits per call

Authentification

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Paramètres de requête

query*string

Keyword, or a Zoro search or category URL. Empty, another host, or a product URL returns 400. A keyword builds /search?q=.... Each card has price as a USD number and price_display as the dollar string.

Keyword

safety glasses

Search URL

https://www.zoro.com/search?q=safety+glasses

Category URL

https://www.zoro.com/safety-glasses/c/6214/
page?number

Page number starting at 1. Omit it for page 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. A value below 1 returns 400.

return_page_source?boolean

Default false. true replaces results and pagination with result, the rendered HTML.

Corps de la réponse

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/zoro/search?query=string'
Example Response
{  "results": [    {      "url": "https://www.zoro.com/mcr-safety-bearkat-bk1-safety-glasses-duramass-hard-coat-clear-lens-non-slip-temple-frameless-bk110/i/G2426514/",      "brand": "Mcr Safety",      "image": "https://www.zoro.com/static/cms/product/full/7e6737c8-0823-4e5f-9c53-2002b0476883.jpeg",      "price": 1.39,      "title": "BearKat (BK1), Safety Glasses, Duramass Hard Coat, Clear Lens, Non-Slip Temple, Frameless",      "mfr_no": "BK110",      "rating": 4.86,      "zoro_no": "G2426514",      "currency": "USD",      "price_unit": "ea",      "review_count": 49,      "package_price": 16.68,      "price_display": "$1.39",      "package_quantity": 12,      "package_price_display": "$16.68"    }  ],  "pagination": {    "next": "https://www.zoro.com/safety-glasses/c/6214/?q=safety+glasses&page=2",    "page": 1,    "per_page": 36,    "total_pages": null,    "total_results": 3000  }}