Help Center Hungary (Árukereső) Árukereső – XML Feed

Árukereső – XML Feed

In order to be able to import products into our search engine, it is necessary to have a so-called XML file or csv file (feed) created. It is a simple data format that you can use to provide us with information about products and their prices. The feed is automatically generated from your site, so consult your webmaster about its creation or modification.

We download your feed every day at 16:00, the update of the given products is displayed the following day. If you need earlier updates, we recommend the premium package.

Required fields
IdentifierThe unique product identifier used by the online store. Its value remains unchanged.
ManufacturerName of the product manufacturer. Optionally, it can also be entered at the beginning of the product name in the “Name” field.Example: Sony
NameProduct name. Beginning with a capital letter, the use of capital letters in other places is allowed only in justified cases (e.g. abbreviation). The name must contain the full name. On the contrary, it must not contain advertising.Example: Cyber-shot DSC-H10If you cannot enter the manufacturer’s name in a separate field, enter it here before the product name.Example: Sony Cyber-shot DSC-H10
CategoryCategorizing the product. We can process continuous, hierarchically structured categories. You can find all used categories here: https://www.arukereso.hu/MainCategories.phpExample: Technology > Consumer Electronics > DVD Players
ProductUrlLink (URL) to the product page.Example: http://www.example.com/products.php?id=45884
PriceThe price of the product for the end user (price including VAT and other taxes that the consumer must pay for the given product). The price of the minimum quantity that can be ordered is shown on the product page.
NetPricePrice without VAT
Other recommended fields
ProductNumberProduct code provided by the manufacturer.ProductNumber must be listed in the feed in the case of electronics, IT, home goods and in those categories in which processing is based on the product code.We only accept product codes used by the manufacturer.
Examples: KD-55XF9005, GV-N166TOC-6GD, 90MP00M1-B0UA00
MaxCPCMultiplierProduct max bid multiplier. With its help, you can determine the multiplication of the list price. That is the cost per click of the recommended position that you are willing to pay compared to the base price of the category.Bid values listed in the feed are accepted by the Árukereső.hu system if they meet the following conditions:”BIDx” is inserted before the bid multiplier.The bid multiplier value is a number between 1.5 and 100.0.The bid multiplier value contains a maximum of one decimal place.Correct formats: “BIDx1.5”; “BIDx1.5”; “BIDx2”; “BIDx9.4”.Invalid formats: “1.5”; “BID:1.5″;”BIDx1.55”.We take into account the multiplier of the product’s maximum offer only in the case of products that we display on ÁrukeresőIf an offer multiplier is set for a product both in the store administration and in the feed, the system will take into account the offer in the store administration.
DeliveryCostThe cost of delivering the product to the customer’s home.If the cost of shipping the product across the country is free, regardless of the weight and price of the product, the correct formats are: FREE; ingyenes; ingyen; ingyenesenIf the cost of transporting a product across the country is set regardless of the product’s weight and price, for example 700 HUF (amount including VAT), the correct formats are: 700; 700 Ft
DeliveryTimeProduct delivery time. The given product will be delivered within this number of working days from the date of placing the order. The data must be entered in days.Correct formats: 2; 2 nap; 2 munkanap (2 working days – the Hungarian version must be displayed in the feed).Incorrect formats: 1 hét; 2-4 nap; raktáron; készleten (1 week; 2 – 4 days; in stock; in stock) For products that can be shipped immediately (or next business day), the correct format is: is: 1; 1 nap; 1 munkanap (1 working day – the Hungarian version must be displayed in the feed)If the product cannot be ordered, enter “NO” (“NO”) in the field and the product will not appear on Árukereső .hu.The information provided is displayed as follows: Raktáron (In stock), Szállítás: max 3 nap (Delivery: max 3 days), Szállítás: max 1 hét (Delivery: max 1 week), Szállítás: max 2 hét (Delivery: max 2 weeks), Szállítás: min 2 hét (Delivery: min. 2 weeks).We can only display this data if it can also be found on the product page. In the case of product pages containing several offers, it must be clearly identifiable which product the information refers to.
EanCodeMin. 8-digit, max. 13-digit product identifier provided by the manufacturer. It must be unique.
ShoppingDisabledDisabling a product in the Árukereső Shopping service.In the list of products, enter the following:1 ⇒ If you do not wish to display the given product in the Árukereső Shopping service.0 (or empty field) ⇒ The given product can be viewed in the Árukereső Shoping service.
EnergyEfficiencyA-GThe energy efficiency class of the given product valid from 1/3/2021, which can be a capital letter between A–G.
EnergyLabelA-GLink (URL) to the image of the new energy label of the product, which came into effect on 1/3/2021.Example: http://www.example.com/energylabels/45884.jpg
DetailedSpecificationA-GLink (URL) to the new detailed technical data sheet of the product, which came into effect on 03/01/2021. We ask that you send the detailed data sheet in pdf or jpg/png format.Example: http://www.example.com/datasheet/93812.pdf
DescriptionProduct description that includes important parameters. So that customers can get accurate information.
ImageUrlLink (URL) to product photo. If an image is available in multiple sizes, it is advisable to provide a link in the best quality. The minimum size we can display is 150 × 150 pixels. Please provide the actual product image. An image that only contains the information “Uploading soon” or a company logo is considered invalid.Example: http://www.example.com/images/45884.jpg
ImageUrl2Link (URL) to product photo if you have multiple images.Example: http://www.example.com/images/45885.jpg
ColorThe dominant color of the product. The field is only used in the fashion category.Please enter only one color for the product. If the product has multiple color variants, enter the product in the feed with a unique identifier and name as many times as it is available in different colors.We can only accept the color if the product color in the attached image matches the color listed in this box. Please do not use the same product image for each version.
SizeProduct size. The field is only used in the Fashion category.Please enter only one size for the product. If a product has multiple sizes, enter the product in the feed with a unique identifier and name as many times as it is available in different sizes.Our system can only interpret EU and International (S/M/L) sizes, we cannot accept other sizes.
GroupIdA grouping of products that are included in the product feed multiple times. Variation may be due to color, size, pattern, or other product characteristics (e.g. memory size).
AttributesA field suitable for transferring product properties. Products sent with parameters are automatically filtered in categories. The more information you provide, the easier your products will be found.We can process product characteristics in XML regardless of the list type, which can be accessed as follows: <Attributes> <Attribute> <Attribute_name>Típus</Attribute_name> <Attribute_value>Fejhallgató</Attribute_value> </Attribute> <Attribute> <Attribute_name>Vezeték nélküli</Attribute_name> <Attribute_value>Igen</Attribute_value> </Attribute> </Attributes>
In the case of a feed in CSV format, the content between the Attributes tags in the example can be placed in the Attributes column of the CSV. In that case, the opening and closing Attributes tags are not needed in the example. The example at the bottom of the page will help to illustrate.For characteristic values of the product, always state the unit of measurement.

Special category

We require different information and tags for the following special categories: DVDs, Books, Tires and Perfumes.

Requirements for the Mobile phones category

We can only display prices for products that are independent of SIM card or service provider and include complete accessories (box, charger, etc.).

Requirements in the DVD FILM category
Mandatory fields:ReleaseDate – the year the film was releasedOriginalTitle – the original English title of the filmName – the name of the film in HungarianPrice – gross price of the product;Category – placing the product in a categoryProductUrl – the unique URL of the product
Recommended field:Description – a brief description of the DVD
Requirements in the BOOK category
Mandatory fields:ISBN13 – 13-digit number (product identifier, must be unique)Name – product name (Book title)Price – gross price of the productProductUrl – the unique URL of the productCategory – placing the product in a category
Recommended fields:ImageUrl – URL link to the product photoAuthor – the name of the author of the bookDescription – a brief description of the bookReleaseDate – year of releasePages – number of pagesWeight – weight including unit of measure (kg, g), e.g.: 1,000 gLanguage – language
Requirements in the TIRES category
Mandatory information in the “Name” tag      Type – e.g. ContiPremiumContact 2Size 1 – e.g. 205/60Size 2 – e.g. R16LI (weight index) – e.g. 96SI (speed index) – e.g. HRun flat/reinforced tires – e.g. RFT, XL

The product name we accept for this tire is: Continental ContiPremiumContact 2 SSR XL 205/60 R16 96H.
The order of individual parameters can change, but the manufacturer should preferably be listed either separately or at the beginning of the product name.

Requirements in the Alloy wheel category
Mandatory information in the “Name” tag      Type – e.g. Dark Blade ANNumber of screws, pitch circle – e.g. 4/100Rim diameter and width – e.g. 15 × 6.5Insertion depth – e.g. ET38Center hole size – e.g. CB72.3

The product name we accept for this alloy wheel is: MOMO Dark Blade AN CB72.3 4/100 15 × 6.5 ET38
The order of individual parameters can change, but the order within parameters cannot. We cannot accept the 6.5 × 15 version for the diameter and width of the rim. The manufacturer should be listed either separately or at the beginning of the product name.

Requirements of the PERFUME category
Mandatory information in the “Name” tag      Manufacturer: HUGO BOSSName – eg BaldessariniType – fragrance concentration, e.g. EDPPackaging – packaging size e.g. 75 mlPackaging – for testers, include the word “Tester” or ” Teszter” in the nameTarget group: e.g. men

The product name we accept for this perfume is: HUGO BOSS Baldessarini EDP 75ml for men
Tester: HUGO BOSS Baldessarini EDP 75ml Tester for men
The order of individual parameters may change, but the manufacturer should be listed either separately or at the beginning of the product name.

Mandatory fields for partners using the Árukereső Marketplace service
DescriptionProduct description that includes important parameters. So that customers can get accurate information.
ImageUrlLink (URL) to product photo. If an image is available in multiple sizes, it pays to link to the best quality. The minimum size we can display is 150×150 pixels. Please provide an actual product image, “Uploading soon” image or company logo is not valid.Example: http://www.example.com/images/45884.jpg
DeliveryTimeProduct delivery time. The given product will be delivered within this number of working days from the date of placing the order. The data must be entered in days.Correct formats: 2; 2 nap; 2 munkanap (2 working days – the Hungarian version must be displayed in the feed).Incorrect formats: 1 hét; 2-4 nap; raktáron; készleten (1 week; 2 – 4 days; in stock; in stock).For products that can be shipped immediately (or next business day), the correct format is: is: 1; 1 nap; 1 munkanap (1 working day – the Hungarian version must be displayed in the feed)If the product cannot be ordered, enter “NO” (“NO”) in the field and the product will not appear on Árukereső .hu.The information provided is displayed as follows: Raktáron (In stock), Szállítás: max 3 nap (Delivery: max 3 days), Szállítás: max 1 hét (Delivery: max 1 week), Szállítás: max 2 hét (Delivery: max 2 weeks), Szállítás: min 2 hét (Delivery: min. 2 weeks).We can only display this data if it can also be found on the product page. In the case of product pages containing several offers, it must be clearly identifiable which offer the information refers to.

For sellers using the Árukereső Marketplace to display offers of combined products in certain categories, in addition to the name used by the manufacturer, the presence of a color is required (for example: ‘Huawei P20 lite 64GB DUAL SIM Night Black’, ‘JBL T110 Headphones, White’, ‘Nikon Coolpix B500 (purple)’). Unfortunately, it is not possible to mark the color with the “Color” tag in this case, as it can only be used in the fashion category for technical reasons.

Recommended fields for Árukereső Marketplace
BasketDisabledDo not display the product in the Árukereső MarketplaceIn the list of products, enter the following:1 ⇒ If you do not wish to display the given product on the Árukereső Marketplace0 (or empty field) ⇒ The product can be viewed on the Árukereső Marketplace
FreeDeliveryFree home delivery can be specified if the product has free delivery in Hungary. And this despite what is stated in the table of fees in the store administration.Its entry is optional, and the default value is 0. The delivery fee is calculated according to the delivery fee table from the store administration.In the list of products, enter the following:1 ⇒ If the product delivery fee in Hungary is 0 regardless of what is stated in the delivery fee table.0 ⇒ If you want to display the product delivery fee according to the Delivery Fee table.
OversizeFor oversized products, the administration offers to determine special delivery fees.In the product list, please enter it as follows:1 ⇒ For products that are subject to “Oversized Products” shipping fees listed in the Shipping Fees Table.0 ⇒ For all other products.
WeightGross product weight, weight calculated with basic accessories and packaging. In addition to the weight of the product, it is mandatory to indicate the unit of measurement, which can be kg or g.Correct formats: 2 kg; 1000 g.Invalid formats: 2; 1000 grams.
DeliveryCostByProductThe cost of delivery of a given product is calculated based on the number of identical items in the cart.Entering this tag is optional and its default value is 0. The delivery fee is calculated according to the delivery fee table from the store administration.Please fill it in the feed as follows:1 ⇒ Determines which products are subject to a delivery fee based on the number of products in the cart.0 ⇒ It does not matter how many products are placed in the cart. Shipping costs will be charged only once.

File formats

The above data can be sent in CSV/TSV or XML format.

Using CSV/TSV format

You can use commas, semicolons, tabs for filling. The first line should contain the name of the fields, the other lines should contain data about the given product. A delimiter character in a data field can only appear if the field is enclosed in quotation marks. In such cases, the quotes should be “escaped”. Our system also supports doubling (“”xy””) and backslash (“xy”) as solutions. Similarly to CSV, you can change tabs in data fields to “space” in TSV. This is why TSV is easier to use in practice. For example, the “fputcsv” function of the PHP programming language works as described above.

CSV example

"category";"manufacturer";"name";"description";"price";"imageurl";"producturl";"deliverytime";"deliverycost";"netprice";"identifier";"eancode"
"Számitógép>Laptop";"HP";"655 C4X91EA LX 2Y";"Processzor: AMD E2-1800 (1700)....";"99900";"http://www.example.com/images/12554.jpg";"http://www.example.com/products.php?id=1231231";"1 munkanap";"2000 Ft";"7866";"A3581231231";"0887111509581";"<attribute><attribute_name>Memória mérete</attribute_name><attribute_value>4 GB</attribute_value></attribute> <attribute><attribute_name>Kijelző felbontása</attribute_name><attribute_value>1366 x 768</attribute_value></attribute> <attribute><attribute_name>Háttértár kapacitása</attribute_name><attribute_value>500 GB</attribute_value></attribute> <attribute><attribute_name>Bluetooth</attribute_name><attribute_value>Van</attribute_value></attribute>"
"Számitógép>Laptop";"Acer";"Aspire V5-121-C72G32akk Black LX 2Y";"Processzor: AMD C-70 Dual Core (1000).....";"69900";"http://www.example.com/images/12555.jpg";"http://www.example.com/products.php?id=1231232";"5 munkanap";"FREE";"55039";"1231232";"";"<attribute><attribute_name>Memória mérete</attribute_name><attribute_value>2 GB</attribute_value></attribute> <attribute><attribute_name>Kijelző felbontása</attribute_name><attribute_value>1366 x 768</attribute_value></attribute> <attribute><attribute_name>Háttértár kapacitása</attribute_name><attribute_value>320 GB</attribute_value></attribute> <attribute><attribute_name>Bluetooth</attribute_name><attribute_value>Van</attribute_value></attribute>"
"Számitógép>Egér";"Hama";"uRage Illuminated 113722";"Gaming egér precíz kurzorvezérléssel";"6900";"http://www.example.com/images/12556.jpg";"http://www.example.com/products.php?id=1231233";"1 munkanap";"2000 Ft";"5433";"1231233";"4047443184320";"<attribute><attribute_name>Egér típusa</attribute_name><attribute_value>Optikai</attribute_value></attribute> <attribute><attribute_name>Csatlakozás</attribute_name><attribute_value>Usb</attribute_value></attribute> <attribute><attribute_name>Vezeték nélküli</attribute_name><attribute_value>Nem</attribute_value></attribute>"
"Műszaki cikk>Fényképező objektív";"Nikon";"AF-S 50mm f/1.8G JAA015DA";"50 mm-es, FX-formátumú általános objektív (Nikon DX-formátumú SLR géppel használva 75 mm-es).";"69900";"http://www.example.com/images/12551.jpg";"http://www.example.com/products.php?id=1231234";"3 munkanap";"2000 Ft";"55039";"1231234";"0018208021994";"<attribute><attribute_name>Kompatibilis bajonettek</attribute_name><attribute_value>Nikon bajonett</attribute_value></attribute> <attribute><attribute_name>Objektív típusa</attribute_name><attribute_value>Standard objektív</attribute_value></attribute> <attribute><attribute_name>Lamellák száma</attribute_name><attribute_value>7</attribute_value></attribute> <attribute><attribute_name>Gyújtótávolság</attribute_name><attribute_value>50 mm</attribute_value></attribute>"

Using the XML format

You can also create a feed in XML format, in which all products must be contained in <products> and </products> tags, and information about a specific product must be grouped in <product> and </product> tags.

XML example

<?xml version="1.0" encoding="UTF-8" ?>
<Products>
	<Product>
		<Identifier>00010</Identifier>
		<Manufacturer>Samsung</Manufacturer>
		<Name>Gear IconX SM-R150</Name>
		<ProductUrl>http://www.onoldala.hu/products/00010/sm-r150.html</ProductUrl>
		<Price>379,97</Price>
		<NetPrice>299,18</NetPrice>
		<ImageUrl>http://www.onoldala.hu/images/smr150.jpg</ImageUrl>
		<Category>Műszaki cikk - Fülhallgató</Category>
		<Description>Kapcsolj környezeti hang üzemmódra, hogy halld a körülötted lévő hangokat is. Így kedvenc zenéid hallgatása mellett is végig a jelenben érezheted magad...</Description>
		<DeliveryTime>1 munkanap</DeliveryTime>
		<DeliveryCost>990 Ft</DeliveryCost>
		<EanCode>8806088369228</EanCode>
		<Attributes>
			<Attribute>
				<Attribute_name>Impedancia</Attribute_name>
				<Attribute_value>16 ohm</Attribute_value>
			</Attribute>
			<Attribute>
				<Attribute_name>Hangszínszabályozó</Attribute_name>
				<Attribute_value>Nincs</Attribute_value>
			</Attribute>
			<Attribute>
				<Attribute_name>Érzékenység</Attribute_name>
				<Attribute_value>89.5 dB</Attribute_value>
			</Attribute>
			<Attribute>
				<Attribute_name>Tömeg (fülhallgatók)</Attribute_name>
				<Attribute_value>16 gramm</Attribute_value>
			</Attribute>
		</Attributes>
	</Product>
	<Product>
		<Identifier>00011</Identifier>
		<Manufacturer>Apple</Manufacturer>
		<Name>Magic mouse MB829ZM</Name>
		<ProductUrl>http://www.onoldala.hu/products/00011/magic-mouse.html</ProductUrl>
		<Price>315,00</Price>
		<NetPrice>248,03</NetPrice>
		<ImageUrl>http://www.onoldala.hu/images/magic-mouse.jpg</ImageUrl>
		<Category>Számítástechnika - Egér</Category>
		<Description>Apple Magic Mouse Multi-Touch technológiával működik...</Description>
		<DeliveryTime>7 munkanap</DeliveryTime>
		<DeliveryCost>FREE</DeliveryCost>
		<EanCode>0885909934140</EanCode>
		<Attributes>
			<Attribute>
				<Attribute_name>Tömeg</Attribute_name>
				<Attribute_value>99 g</Attribute_value>
			</Attribute>
			<Attribute>
				<Attribute_name>Multi-touch</Attribute_name>
				<Attribute_value>Igen</Attribute_value>
			</Attribute>
			<Attribute>
				<Attribute_name>Csatlakozók</Attribute_name>
				<Attribute_value>Bluetooth, Lightning port, Wireless</Attribute_value>
			</Attribute>
		</Attributes>
	</Product>
</Products>

You can find the price list of services directly on the Árukereső website.

Was this article helpful?

Související články

Expansion

This article was created by Expandeco exclusively for Heureka. Why Expand? The European Single Market and unified rules for mail-order sales provide a very simple and essential foundation for the overall European e-commerce ecosystem. The terms and r…

Árukereső – Conversion Tracking

What is the Conversion Tracking Conversion Tracking is a tool that shows you how many users who came from Árukereső actually completed a purchase with you, down to the level of specific products and categories. Simply put: thanks to conversion tracki…

Árukereső – Bidding

In short, Bidding is a tool to increase the cost per click (CPC) for individual products. Thanks to it, you can appear in the top three positions of recommended offers in the product detail. This service can be used for product cards on which offers…