Arukereso APIarukereso.hu ↗
Access product prices, specs, shop offers, and reviews from Arukereso.hu via 6 endpoints covering motherboards, batteries, UPS systems, and general search.
What is the Arukereso API?
The Arukereso.hu API provides access to Hungary's largest price comparison site through 6 endpoints covering product search, category listings, detailed specifications, shop offers, and user reviews. The get_product_details endpoint returns structured spec key-value pairs alongside per-shop pricing, shipping terms, and availability, while search_products lets you query across all categories by keyword or brand name.
curl -X GET 'https://api.parse.bot/scraper/f2f18af5-6339-4554-b592-2b7ee600a1a1/get_motherboards?page=1' \ -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 arukereso-hu-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.
from parse_apis.árukeresõ_hu_api import Arukereso, ProductSummary, Product, BatteryProduct, Offer, Review, ProductNotFound
arukereso = Arukereso()
# Search for products by keyword
for product in arukereso.productsummaries.search(query="laptop"):
print(product.name, product.price, product.offer_count)
break
# Browse motherboards with pagination
for mobo in arukereso.productsummaries.list_motherboards(limit=5):
print(mobo.name, mobo.price, mobo.specs)
# Get full product details from a listing result
for item in arukereso.productsummaries.list_motherboards(limit=1):
detail = item.details()
print(detail.name, detail.specs)
for offer in detail.offers:
print(offer.shop_name, offer.price, offer.availability)
break
# Get reviews via sub-resource navigation
for item in arukereso.productsummaries.list_motherboards(limit=1):
for review in item.reviews.list():
print(review.reviewer, review.date, review.rating, review.text)
break
# Browse lead acid batteries with value metrics
for battery in arukereso.batteryproducts.list_lead_acid(limit=3):
print(battery.name, battery.voltage_v, battery.capacity_ah, battery.price_value_ratio)
# Browse UPS batteries
for ups in arukereso.batteryproducts.list_ups(limit=3):
print(ups.name, ups.price, ups.voltage_v, ups.capacity_ah)
# Fetch product details directly by URL
detail = arukereso.products.get(url="https://www.arukereso.hu/alaplap-c3128/msi/mpg-b550-gaming-plus-p572974758/")
print(detail.name, detail.url)
# Handle product not found
try:
arukereso.products.get(url="https://www.arukereso.hu/nonexistent-p999999999/")
except ProductNotFound as e:
print(e.url)
Get a paginated list of motherboards from the motherboard category on arukereso.hu. Returns 25 products per page with name, price, offer count, and specs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number, starting from 1. |
{
"type": "object",
"fields": {
"page": "string representing the requested page number",
"products": "array of motherboard product objects with name, url, price, offer_count, and specs"
},
"sample": {
"data": {
"page": "1",
"products": [
{
"url": "https://www.arukereso.hu/alaplap-c3128/msi/mag-b650-tomahawk-wifi-p872103225/",
"name": "MSI MAG B650 Tomahawk WIFI Alaplap",
"price": 66890,
"specs": {
"Chipset": "AMD B650",
"CPU Foglalat": "Socket AM5",
"Memória típusa": "DDR5",
"Processzor gyártó": "AMD"
},
"offer_count": 7
}
]
},
"status": "success"
}
}About the Arukereso API
Category and Search Endpoints
Three category endpoints — get_motherboards, get_lead_acid_batteries, and get_ups_batteries — return paginated lists of 25 products per page. Each product object includes name, url, price, offer_count, and specs. The battery endpoints (get_lead_acid_batteries and get_ups_batteries) go further by extracting voltage_v and capacity_ah from product specs and computing a price_value_ratio calculated as (V × Ah) / price, making it straightforward to rank batteries by energy-per-forint without post-processing. Pagination is controlled with the page integer parameter starting from 1.
The search_products endpoint accepts a query string and returns matching products with the same name, url, price, offer_count, and specs fields as the category endpoints. It performs best with product names and brand names such as laptop or iPhone. Descriptive multi-word phrases may return fewer results depending on how Arukereso.hu indexes them.
Product Detail and Review Endpoints
get_product_details requires a full product URL (obtained from any listing or search result) and returns the product's full specs object — all specification key-value pairs available on the product page — plus an offers array. Each offer entry includes shop_name, price, shipping, and availability, enabling direct cross-shop price comparison for a single SKU.
get_product_reviews also takes a full product URL (one that contains an embedded product ID in the format -p572974758/) and returns a reviews array. Each review object contains reviewer, date, rating, and text. Reviews are sourced from user-submitted content on Arukereso.hu and reflect the opinions tied to that specific product listing.
The Arukereso API is a managed, monitored endpoint for arukereso.hu — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when arukereso.hu 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 arukereso.hu 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?+
- Comparing motherboard prices and offer counts across Hungarian online shops using
get_motherboards - Ranking lead-acid batteries by energy efficiency using the pre-computed
price_value_ratiofield fromget_lead_acid_batteries - Building a UPS selection tool that filters by voltage and capacity using
get_ups_batteries - Aggregating per-shop offers including shipping and availability for a specific product via
get_product_details - Displaying Hungarian user reviews and ratings for electronics products using
get_product_reviews - Monitoring price changes for specific product URLs by periodically calling
get_product_details - Building a brand-specific product catalog for the Hungarian market using
search_productswith brand name queries
| 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 Arukereso.hu have an official developer API?+
What does the `price_value_ratio` field in the battery endpoints represent?+
(voltage_v × capacity_ah) / price. It gives a normalized energy-per-forint figure so you can sort batteries by cost-efficiency without doing the arithmetic yourself. Both get_lead_acid_batteries and get_ups_batteries include this field alongside the raw voltage_v and capacity_ah values.Can I retrieve products from categories other than motherboards, lead-acid batteries, and UPS systems?+
search_products to find products in other categories by keyword, though it returns the same basic fields (name, url, price, offer_count, specs) without category-specific computed fields like price_value_ratio. You can fork this API on Parse and add a new category endpoint targeting any other Arukereso.hu category.How do I get shop-level pricing and availability for a product?+
get_product_details accepts a full product URL and returns an offers array. Each element contains shop_name, price, shipping, and availability. You get the product URL from any listing endpoint or from search_products.Is it possible to filter search results by price range or category?+
search_products endpoint currently accepts only a query string — there are no parameters for price range, category, or sort order. You would need to filter the returned results client-side based on the price field. You can fork this API on Parse and revise the endpoint to add filtering parameters.