Skip to main content
Piloterr
Back to library

Zooplus Search API

Zooplus Search API. Search pet food and supplies by keyword or URL across 26 Zooplus/Zoohit shops. Parses Next.js RSC initialStoreState; returns prices, ratings and pagination.

Active1 credit = 1 requestGET/v2/zooplus/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Zooplus Search API returns pet product listings from Zooplus online shops. Pass a keyword or a full search URL, optionally with region and page, and receive structured JSON with prices, ratings, summaries, and pagination.

Piloterr fetches the SSR HTML and parses the Next.js RSC stream (self.__next_f.push + initialStoreState). No browser rendering required.

Use each result url or product_id with Zooplus Product for full PDP data.

Supported regionsLink to Supported regions

26 footer regions. Default: frwww.zooplus.fr.

region Domain Currency Aliases
fr zooplus.fr EUR fr-fr
de zooplus.de EUR de-de
gb zooplus.co.uk GBP uk, en-gb
pl zooplus.pl PLN pl-pl
cs zoohit.cz CZK cz, cs-cz
ch-fr zooplus.ch/fr CHF fr-ch
com zooplus.com EUR en, intl
see docs 26 regions total

When query is a full Zooplus/Zoohit URL, domain and region are detected automatically (region is ignored).

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/zooplus/search?query=croquettes+chat
GET https://api.piloterr.com/v2/zooplus/search?query=croquettes+chat&region=fr
GET https://api.piloterr.com/v2/zooplus/search?query=https://www.zooplus.fr/search/results?q=croquettes+chat
GET https://api.piloterr.com/v2/zooplus/search?query=croquette&page=2

ParametersLink to Parameters

Parameter Type Required Description
query string yes Keyword or full search URL
region string no Country when query is a keyword (default: fr)
page integer no 1-based page override (default: from URL or 1)
return_page_source boolean no Raw HTML as {"result": "..."} (default: false)

Listings (results[])Link to Listings (results[])

Field Type Description
product_id string shopIdentifier
title string Product title
url string Absolute product URL
image_url string | null Card image (picture400 / picture200)
price number | null Displayed price
currency string ISO currency from shop
summary string | null Short teaser text
rating number | null Average rating
review_count integer | null Number of reviews
variant_count integer | null Available variants
is_on_sale boolean | null Reduced price flag
is_new boolean | null New product flag

PaginationLink to Pagination

Field Type Description
page integer Current page
per_page integer Results on this page (deduplicated count)
total_results integer | null Often null
total_pages integer | null Total pages
next string | null Next page URL (p=2, …)

Raw SSR pages may contain ~48 entries; results are deduplicated by shopIdentifier.

Zooplus workflowLink to Zooplus workflow

  1. Zooplus Search to discover listings (this endpoint)
  2. Zooplus Product for full PDP JSON

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query / region
404 Page without parseable search state
500 Network or parsing error

NotesLink to Notes

  • Pagination uses query param p, not page.
  • Costs 1 credit per call (HTTP crawler).

Main use casesLink to Main use cases

  • Pet retail discovery: harvest product ids across keywords and regions
  • Price monitoring: track promotions (is_on_sale) on food and accessories
  • Catalog intel: ratings and variant counts before fetching full PDP data

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included