What is a price file?

A price file is a database file that we need in order to index the prices from a shop's website. It should ideally be stored on the shop's server. We index the price file three to five times every 24 hours to keep our listings updated.

Once you have a complete price file, you may forward a link to us by e-mail to: support@pricespy.co.nz
(please do NOT send the whole file). If you change the name of the price file, please send an email to our support department and attached an updated link. Do not use dates in the filenames.

What should a price file look like?

Your e-commerce system will most likely be able to export a list of your products including prices as a text file. The file does not have to be static, it may be a script which collects information directly from your database in a dynamic manner.   
If the file is static, please make sure it is updated on a regular basis. Otherwise there is a risk that old prices may be displayed at PriceSpy, which could cause unhappy consumers. Please contact us if you have any questions or queries. Should your shop already be listed on a different price comparison site we will most likely be able to use the same price file.

Please note
We might be able to use your price file even if you fail to meet our mandatory requirements.


  • A basic tab-separated text file will do, in fact we prefer this instead of complex XML-standards.
  • The price file must contain your shop's whole product range.
  • Different variations (sizes, colours, etc) should be named as a new product with a unique name and article number. We will group them in our listings when applicable.

Mandatory information

  • Product name
    What you call the product in your shop
  • Article number
    Your article number or otherwise unique product ID (maximum 32 characters).
  • Manufacturer
  • URL to the product page
  • Product category
    Your term, as accurate as possible, ie the whole 'category tree' if several levels exist
  • Price
    Price per unit (inc. or ex. VAT, please specify)
  • Status
    Specify if your product is one of the following:
    • Normal
      No information needed in the price file
    • Used
      Used product
    • Not available for purchase
      Has a price in shop but cannot be bought
    • Demo
      A demo product or display product
    • Download
      Product that can only be downloaded, for example a video game
    • Pick-up
      Product only available for pick-up in a physical shop after being ordered online

Voluntary information

  • Shipping cost
    Specify the shipping price only or the product price including shipping
  • Stock status
    Specify if the product is in stock (yours or the manufacturer).
    • Green icon
      "Yes, "Y", "In stock" or similar. The amount of products in stock will also work. If you specify in a different way, like "3-4 days", it may need manual adjustment by us in order to be scanned. Green status requires that the product can be delivered within 6 working days.
    • Yellow icon
      "Incoming", "Advanced booking" or the date when the product is expected to be in stock. This only applies to products that will be in stock soon.
    • Red icon
      "No", "N", "Not in stock", "0".
  • Manufacturers article number
  • EAN code
  • Image URL
    URL for a large product image without watermarks.
You can find an example of how a semicolon delimited price file may look here. Feel free to use this as a template if you wish, but there is no requirement to use the same order or names on the columns as seen in the file. Please contact us if you have any questions: support@pricespy.co.nz

For users of OsCommerce e-commerce solutions, we have a complete script available for downloaded here. Please install the script in OsCommerce's root directory on your web server and then contact us. 

How do I get started?
If you have any questions or queries, please contact support@pricespy.co.nz