Skip to main content
API Endpoints

What are the API links and how to use it

Steffan H. Mathiasen avatar
Written by Steffan H. Mathiasen
Updated over a year ago

When you want to set up dynamic pricing, PriceShape delivers the new prices for products with endpoints containing the attribute <new_price>

The endpoints can be found under settings page of your PriceShape account, clicking your name in the top right corner inside PriceShape and then in the drop-down called 'API links'

The endpoints have the following format:

https://app.priceshape.dk/api/FORMAT/products?auth-token=TOKEN

Issuing a GET request to the given endpoints, will return the requested data in either JSON, XML or CSV. The different endpoints contains the following

  • Call: Contains all products that have competitors data - when no products have competitor data the endpoint will give a 404 error

  • Call with new prices: Contains all products that have a new price - when no products have a new price the endpoint will give a 404 error

  • Call with manual prices: Only contains products that have manually set new price - when no products have a manually set new price the endpoint will give a 404 error

An example XML response from XML with new price for one products (the response will contain all products with a new price)

<item>

    <gid>6542122953</gid>

    <mpn>3113352</mpn>

    <gtin>5702213112522</gtin>

    <link>https://priceshapedemo.dk/product/5709513142522</link>

    <price>799.95</price>

    <title>Large Good Book</title>

    <median>2227.5</median>

    <average>2348.45</average>

    <new_price>825.75</new_price>  <-- The new price for the products 

    <image_link>https://priceshape.com/product-image/very-nice-image.jpg</image_link>

    <clear_price>425</clear_price>

    <availability>out of stock</availability>

    <item_group_id>2</item_group_id>

    <custom_label_0>label</custom_label_0>

    <custom_label_1>custom_label_1</custom_label_1>

    <custom_label_2>custom_label_2</custom_label_2>

    <custom_label_3>custom_label_3</custom_label_3>

    <price_strategy>PT + DT</price_strategy>

<priceshapeScraper>

<competitor>

<domain>competitordomainname.com</domain>

<clear_price>3179</clear_price>

<availability>in stock</availability>

</competitor>

<competitor>
....

</competitor>

</priceshapeScraper>

<productowner>Steffan</productowner>

<extra_attribute1>2</extra_attribute1>

<extra_attribute2>2</extra_attribute2>

</item>

NOTE: The response might not look 100% like the above response, if some of the attributes is missing for the account or extra is added. All attributes after <priceshapeScraper> contains all unmapped attributes that PriceShape receives.

The attribute <new_price> will contain the new price for the product, when PriceShape registers that the product price = new price, the products will be removed from the response.

You now have the newest recommended price for your product.

You can read more on how data circulates between your system and PriceShape here (a PriceShape user is required to read the article)

If you have any questions, don't hesitate to reach out to us.

Did this answer your question?