Skip to content

Sources

kwery normalizes every marketplace into a consistent result shape, while preserving the fields that are specific to each one. This section documents what you get per source.

Supported sources

kwery covers 12 sources in total:

SourceKeysTopicsExample countries
Amazonterm, asin, gtinsearch, search_and_offersde at ch fr it es uk us …
Google Shoppingterm, id, productsearchde at ch fr it es uk us nl be …
eBayterm, id, gtinsearchde at fr it es uk us au ca …
Idealoterm, id, gtin, pznsearchde at uk fr it es
Kauflandterm, id, gtinsearch, search_and_offersde cz sk pl at fr it
Ottoterm, idsearchde
Billigerterm, id, gtinsearch, search_and_offersde
Guenstigerterm, id, gtinsearch, search_and_offersde
Walmart (rolling out)term, id, gtinsearch, search_and_offersus
Lidl (rolling out)term, idsearchde at fr it nl pl uk …
AliExpress (rolling out)term, idsearch, search_and_offersus
Rakuten (rolling out)term, idsearch, search_and_offersjp

Amazon, Google Shopping, eBay, and Idealo are crawled natively. Kaufland, Otto, Billiger, and Guenstiger are also crawled directly. Walmart, Lidl, AliExpress, and Rakuten are covered through kwery's partner data feeds and normalized into the same result shape as every other source — you use them exactly the same way.

Rolling out. The four partner-feed sources — Walmart, Lidl, AliExpress, and Rakuten — are onboarding now and are not yet enabled by default on new accounts. Contact us to be enabled as they go live. The eight crawled sources are live today.

Access is granted per source.country pair — see Authentication.

How to read the field tables

Each source page lists the fields in the content object of a product result. Common, cross-source fields include:

FieldDescription
nameProduct title.
urlCanonical product URL on the marketplace.
currencyISO currency of the prices.
price_min / price_avg / price_maxAggregates across the gathered offers.
offers_countNumber of seller offers gathered.
offersArray of seller offers (see each source for fields).
review_rating / review_countAggregate review signal, where available.

Seller offers in offers[] typically include the seller/shop name, price, currency, shipping, and condition. Idealo carries the richest offer detail; see its page.

Seller-name resolution

For some sources, seller/shop names are not always present on the first page load. kwery can resolve missing seller names for you — when this option is enabled on your account, the service performs the extra lookups needed to populate shop_name (and marketplace fields) on offers, and reports how many resolutions ran in the result counters. This is an account-level option; contact us to enable it for your plan.

Sources are enabled per account. Contact us if you need access to one that isn't yet active on your account — we'll confirm coverage and the available keys for your use case.