Chewy Products Finder API

OverviewLink to Overview

The Chewy Products Finder endpoint allows you to discover Chewy product URLs by searching with a product name, ID, or any combination of filters. It is primarily designed as a pre-step before calling the Website Rendering API on Chewy product pages, enabling you to resolve identifiers into actionable product URLs.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/finder/chewy-products?search=dog+food

ParametersLink to Parameters

ResponseLink to Response

Default responseLink to Default response

Returns a JSON array of product objects:

[
  { "id": "312253", "url": "...", "title": "...", "domain": "com" }
]

Response when count=trueLink to Response when count=true

Returns an object with the total estimated number of matches and the page of results:

{
  "count": 842,
  "hits": [
    { "id": "312253", "url": "...", "title": "...", "domain": "com" }
  ]
}

Response fieldsLink to Response fields

ExamplesLink to Examples

Free-text searchLink to Free-text search

GET /v2/finder/chewy-products?search=dog+food

Lookup by one or several IDsLink to Lookup by one or several IDs

GET /v2/finder/chewy-products?id=312253,312254

Search restricted to a domain, paginatedLink to Search restricted to a domain, paginated

GET /v2/finder/chewy-products?search=salmon&domain=com&limit=20&offset=20

Get total count and a slice of resultsLink to Get total count and a slice of results

GET /v2/finder/chewy-products?search=dog+food&count=true&limit=10

Advanced filterLink to Advanced filter

GET /v2/finder/chewy-products?filter=domain%20%3D%20%22com%22%20AND%20title%20CONTAINS%20%22puppy%22

NotesLink to Notes

• At least one of search (or query) or a filter (id, domain, filter, ...) must be provided.
• Returns up to limit results ordered by relevance (or by sort if provided).
• When count=true, an empty result set returns { count: 0, hits: [] } with a 200 status. Without count, an empty result set returns a 404.
• Use returned URLs with the Website Rendering API to extract full product data.
• Accepts both free-text product names and numeric product IDs.

Main use casesLink to Main use cases

• Find Chewy product URLs by keyword or ID before rendering product detail pages.
• Resolve a batch of internal product IDs to URLs in a single call.
• Build a pet supplies product catalog from Chewy.
• Estimate the size of a result set with count=true before paginating through it.
• Automate price monitoring pipelines for pet food, treats and accessories.
• Cross-reference product references across pet supplies retailers.