Verkkokauppa APIverkkokauppa.com ↗
Access Verkkokauppa.com product data via API: search, pricing, availability, reviews, outlet/clearance listings, and full category browsing across Finland's largest electronics retailer.
What is the Verkkokauppa API?
The Verkkokauppa.com API provides 11 endpoints covering product search, detailed specs, real-time pricing, store-level stock availability, customer reviews, and category/sale/outlet browsing for Finland's largest electronics retailer. The get_product_details endpoint alone returns name, brand, description, specifications, images, price, and warehouse availability in a single call, while get_store_availability breaks down stock by shipment, pickup, and individual store locations.
curl -X GET 'https://api.parse.bot/scraper/e51a9cee-df5a-492b-bb34-75d4f2a85f7e/search_products?page=1&sort=-score&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace verkkokauppa-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Verkkokauppa.com SDK — search, browse, and inspect products."""
from parse_apis.verkkokauppa_com_api import Verkkokauppa, Sort, ProductNotFound
client = Verkkokauppa()
# Search for laptops sorted by price ascending
for product in client.products.search(query="laptop", sort=Sort.PRICE_ASC, limit=5):
print(product.id, product.name, product.price_current, product.brand)
# Browse clearance deals
for deal in client.products.clearance(limit=3):
print(deal.name, deal.price_current, deal.discount_percentage)
# List top-level categories
for cat in client.categories.list(limit=5):
print(cat.id, cat.label, cat.product_count)
# Browse products in a specific category
laptops = client.category(id="laptops")
for product in laptops.products(limit=3):
print(product.name, product.price_current, product.href)
# Get reviews for a product from search results
product = client.products.search(query="lenovo", limit=1).first()
if product:
for review in product.reviews.list(limit=3):
print(review.rating, review.user_nickname, review.review_text, review.submission_time)
# Typed error handling
try:
detail = client.products.get(id="9999999999")
print(detail.name)
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
print("exercised: products.search / products.clearance / categories.list / category.products / reviews.list / products.get")
Full-text search over all Verkkokauppa.com products. Returns paginated results with product data (name, price, images, rating), included category/campaign details, and pagination metadata. Sorted by relevance (-score) by default. Each page returns up to 48 products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| sort | string | Sort order. Accepted values: -score, -popularity, price, -price. |
| queryrequired | string | Search keyword. |
{
"type": "object",
"fields": {
"data": "array of product objects with attributes including name, price, images, rating, and category relationships",
"meta": "object containing totalResults and search variant info",
"included": "array of related resources such as sales categories, brands, and campaigns"
},
"sample": {
"data": {
"data": [
{
"id": "939670",
"type": "products",
"attributes": {
"name": "Käytetty HP EliteBook 830 G6",
"price": {
"current": 249.99,
"original": 349.99
}
},
"relationships": {
"brand": {
"data": {
"id": "10849",
"type": "brands"
}
}
}
}
],
"meta": {
"totalResults": 752
},
"included": [
{
"id": "used_laptops",
"type": "salesCategories",
"attributes": {
"label": "Käytetyt kannettavat"
}
}
]
},
"status": "success"
}
}About the Verkkokauppa API
Product Search and Filtering
The search_products endpoint accepts a query string and an optional sort parameter (-score, -popularity, price, -price) and returns paginated data arrays of product objects alongside included resources such as brands, sales categories, and campaigns. For more targeted queries, search_with_filters adds a filters input that accepts a JSON string of attribute key-value pairs — for example {"base+brand": "Samsung"} — allowing brand or attribute-scoped searches without a keyword. Both endpoints expose meta.totalResults for building pagination controls.
Product Details, Pricing, and Availability
get_product_details returns a single product's full attribute set: name, description, brand, price, specifications, images, and an availability object with warehouse and store-level stock data, plus rating_stats containing review count, average rating, and rating distribution. When only price and availability are needed, get_product_price_and_availability provides a lighter payload with current and original prices, tax rate, and any active discount details without the full spec overhead.
get_store_availability returns a dedicated availability snapshot per product, including boolean flags (isReleased, isSoldOut, isShippingAllowed) and a stocks object broken into shipment, pickup, and per-store sub-objects, each with individual counts and availability flags. An updatedAt ISO timestamp indicates data freshness.
Categories, Sales, Outlet, and Reviews
get_category_list returns the full category tree as data (top-level categories with label, slug, and productCount) and included child categories, giving you the category_id slugs needed by get_category_products. The search_products_on_sale and get_clearance_products endpoints surface discount-priced items; get_outlet_products specifically covers customer-return stock and adds an outlet-specific customerReturnsInfo and condition field to each product object. Note that outlet and review endpoints return a 0-indexed pageNo in the response, even though they accept 1-indexed page input.
get_product_reviews returns an array of reviews objects, each with rating, reviewText, userNickname, submissionTime, and secondaryRatings. Products with no reviews return an empty array with totalItems: 0. Reviews may include syndicated content from related product variants.
The Verkkokauppa API is a managed, monitored endpoint for verkkokauppa.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when verkkokauppa.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official verkkokauppa.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track real-time price drops on specific product IDs using
get_product_price_and_availabilityfor deal-alert tooling. - Build a Finnish electronics price comparison tool by pulling search results across multiple category slugs from
get_category_products. - Monitor per-store stock levels with
get_store_availabilityto surface which Helsinki or Tampere locations have an item in stock for pickup. - Aggregate customer review sentiment using
reviewTextandratingfields fromget_product_reviewsacross product categories. - Populate a deal-discovery feed by combining
search_products_on_sale,get_clearance_products, andget_outlet_productsfor discount and return stock. - Sync a product catalog with full specs and images by iterating categories via
get_category_listand fetching details throughget_product_details. - Filter competitor or brand-specific listings using the
filtersparameter insearch_with_filterswith abase+brandkey.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Verkkokauppa.com have an official public developer API?+
What does get_outlet_products return that regular search endpoints don't?+
customerReturnsInfo and condition fields specific to returned stock, and the response uses a distinct schema with pageNo (0-indexed), numPages, totalItems, and a products array — rather than the data/meta/included structure used by search and category endpoints.Does the API cover product questions and answers, or seller/third-party listings?+
How does pagination work across different endpoints?+
page integer and return meta.totalResults. The get_outlet_products and get_product_reviews endpoints also accept 1-indexed page input but return a 0-indexed pageNo in the response along with numPages and totalItems, so callers should use the response numPages field rather than inferring page count from totalResults.